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.0 KiB
3.0 KiB
34 · 多选框 Checkbox
34.1 用途
在一组选项里同时选中任意多项（兴趣标签、订阅范围、筛选维度），并支持「全选」；移动端与桌面端的关键差别是半选态的表达：触屏上没有鼠标悬停预告状态，全选行在「部分选中」时必须显示出与「全选 / 全不选」都不同的第三态（横杠），且整行（方框 + 文字）都是热区，行高不小于 44px。
34.2 结构（anatomy）
group：根元素，role="group"+aria-label说明这组在选什么item：单个选项，整行都是热区（原生button+role="checkbox"）icon：方框，未选中是空心框、选中是品牌底 + 反色勾号、半选是品牌底 + 横杠label：选项文字，占满剩余宽度desc：可选说明行，跟在文字下方（如「需先绑定手机号」）all：全选行，不存储自己的状态，由组内各项推导
34.3 变体维度
orientation：vertical（纵向排列，组内画分隔线）/horizontal（横向排列，靠间距分组）button：false（方框 + 文字）/true（胶囊标签式，无方框）selectAll：false（不显示全选行）/true（组首显示全选行）
34.4 状态
- default：未选中（空心框）
- checked：选中（品牌底 + 反色勾号，
aria-checked="true"） - indeterminate：半选，只在全选行出现（
aria-checked="mixed"） - disabled：置灰且不可聚焦，读屏播报不可用
34.5 交互与触控
- 整行（方框 + 文字）都是热区，行高不小于 44px；横向组里每项自身也保持这个边长
- 一次触摸即切换，各项互相独立；不限制同时选中的数量上限
- 点全选行：只要还有未选中项就全部选中，否则全部清空（不在「半选」上停留）
- 全选的选中态是推导值，不单独存储 —— 单项变化后立即重算，避免出现「全选已勾上但还有一项没选」
- 切换动效是勾号 150ms 缩放；减少动态偏好下瞬时切换
- 每次切换立即触发 change 事件，回传切换后的完整值数组
34.6 无障碍
- 组用
role="group"+aria-label说明分组名称 - 每项是原生
button+role="checkbox"+aria-checked（读屏会播报「复选框，已选中/未选中」） - 全选行的半选态用
aria-checked="mixed"（checkbox 角色允许的第三个值） - 方框与勾号是纯装饰，对读屏隐藏（
aria-hidden），语义全靠role="checkbox" - 禁用项用原生
disabled并补aria-disabled="true"
34.7 doNotInvent
- 「最多选 N 项」的数量上限与超出提示（业务规则在宿主）
- 分组嵌套（一组里再分组）的层级表达
- 与表单一起提交时的隐藏字段（由宿主添加）
- 选项内容的异步加载与「已选 N 项」的汇总条
34.8 unknowns
- 全选行是否显示「已选 2/5」这类计数
- 半选态在非全选行上的用例（如父级节点）
- 胶囊按钮式是否也需要禁用态的视觉层（当前复用同一条置灰规则）