aurora-admin
f1fbfc2ddb
Regression / regression (push) Canceled after 0s
## 品牌标识（本次会话） 起因：品牌此前没有任何图形标识 —— 唯一 favicon 是内联 data-URI 里的字母「A」， 那是 v2.0.0「Aurora Admin → Kole UI」改名漏掉的一处（PC 顶栏也是「A」， 移动端站已是「K」；移动端文档站则完全没有 favicon）。 - 几何：24 网格三个互不接触的笔画（竖 + 两斜），圆头描边； 描边 2.25 → 16px 标签页尺寸下正好 1.5px = 规范原文「描边1.5px」 - 取色分两套（刻意）：favicon 硬编码品牌蓝/白（渲染在浏览器标签栏，不继承 kole-dark）； 顶栏标记走 currentColor（实测暗色下自动转 rgb(20,22,28)） - 新增 theme-color 双条（light #FFFFFF / dark #1C1F26，取 --kole-color-card-bg） - 修 site/app.js hero 标语 KOLE ADMIN → KOLE UI（改名变形残留） - 移动端 7 个模板补 favicon（此前计数 0） 验收：门禁 9 条全 OK（site-routing/site-routes/mobile-docs/mobile-site/isolation/ theme/nav/i18n/icons）；PC 回归 1464/1464 · 移动端 807/807，各连跑 8 次一致； 两端 favicon 405 字节逐字节一致；PC 站控制台错误 1→0。 ## 并行会话成果（本次一并入库） - 图标系统：2576 图标（TDesign/Element Plus，MIT）+ 11 端注入 + 5 个构建门禁工具 + IconPreview 预览页 + ICON-SPEC.md 冻结规格 - 移动端平台：47 组件 × 6 端 + 文档站 53 页 + 隔离门禁 - PC 组件：103 个大后台组件 / 组件11 批次 - uni-app：PC 端试点 + 移动端端实现 + 真实编译验证 ## 工程 - .gitignore 补 .scratch/ 与 .zcode-preexisting-*.txt（会话中间产物，实测 9.1MB，不入库） - CHANGELOG 补品牌标识条目 - ROADMAP 登 S8-P4（品牌标识任务包 + og:image/apple-touch-icon 未做部分）
3.2 KiB
3.2 KiB
43 · 选择器 Picker
43.1 用途
从一组有限且已知的选项里选出一项或几项（城市、分值、时间），是「表单里那个下拉框」在触屏上的形态；移动端与桌面端的关键差别是没有悬停、也没有空格去展开：下拉框在手机上只能变成从底部升起的滚轮浮层，手指点选即高亮，并且必须有明确的「确定 / 取消」来收口 —— 桌上点一下就走、触屏上误触代价大，用户需要一次反悔的机会。可绑定到 Popup 的底部形态（position: bottom），但本组件自带遮罩与面板，不要在弹出层里再套一层。
43.2 结构（anatomy）
mask：遮罩，点击关闭（closeOnMask=false时不关）picker：底部浮层面板，role="dialog"+aria-modal="true"picker__header：取消 / 标题 / 确定三格，标题元素由aria-labelledby指向picker__columns：列容器，mode=single一列、mode=multiple多列等分picker__column：单列，role="listbox"+aria-label说明这列在选什么，可滚动picker__option：单个选项，role="option"+aria-selected，行高不小于 44px
43.3 变体维度
mode：single（单列滚轮）/multiple（多列滚轮，各列独立选中；是否联动由宿主的选项决定）round：false（直角）/true（靠内容一侧切圆角）
43.4 状态
- default：常态
- open：浮层展开（遮罩可点、面板滑入）
- closed：收起态（遮罩
pointer-events: none，页面可正常滚动与点击） - selected：当前选中项，
is-selected与aria-selected="true"同步表达 - disabled：整块或单个选项置灰且不响应，写
aria-disabled="true"（整块禁用用状态类is-disabled）
43.5 交互与触控
- 遮罩点击关闭；
closeOnMask=false时不关闭 - 选项行高不小于 44px，滚动容器
-webkit-overflow-scrolling: touch - 点击选项只改本列高亮（同列其余项取消高亮），不改宿主的值；确认时才提交
- 确定 / 取消按钮热区不小于 44px
- 取消防返回：点取消或遮罩丢弃本次点选，宿主侧的值回到打开前的状态
43.6 无障碍
- 浮层
role="dialog"+aria-modal="true"，标题元素 id 由aria-labelledby指向 - 每列
role="listbox"+aria-label，选项role="option"+aria-selected - 遮罩
aria-hidden="true"（纯装饰，读屏不播报） - 选中值以文本呈现在标题里（不依赖视觉滚动位置），收起态写
aria-hidden="true" - 禁用项写
aria-disabled="true"，读屏播报不可用
43.7 doNotInvent
- 选项数据源与联动规则（由宿主传入
columns，本组件不发明城市库或级联关系） - 滚轮惯性 / 吸附动画的物理参数
- 搜索过滤与键盘输入定位（那是 Input / Search 的职责）
- 多选（一次选多个值）——本组件是「多列各选一项」，不是「一列选多项」
43.8 unknowns
- 面板最大高度是否应随列数增长（当前固定
max-height一列 200px） - 是否要支持「不选」的空值项
- 列数上限（当前实现不限制，但三列以上在 375px 宽度下每列会很窄）