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 未做部分）
2.5 KiB
2.5 KiB
29 · 开关 Switch
29.1 用途
即时启停一项配置或业务状态（启用通知、公开数据、自动同步）；移动端与桌面端的关键差别是热区：开关本体视觉只有 48×28，但整行（开关 + 文字）都是可点热区，行高不小于 44px，否则手指点不中；关态与开态也不能只靠颜色区分，必须同时看到滑块位移。
29.2 结构（anatomy）
switch：根元素，一行里放进「轨道 + 文字标签」，整行可点track：轨道，承载背景色与滑块位移的边界knob：滑块，关态靠左、开态靠右（位移是开/关的主要视觉信号）text：可选文字标签，说明这项开关控制什么control：可点的整行控件（原生button+role="switch"），承接键盘与读屏
29.3 变体维度
size：default（轨道 48×28）/small（轨道 40×22，用于紧凑表单）labelPlacement：right（文字在开关右侧，默认）/left（文字在左侧，值区右对齐时用）
29.4 状态
- off：关态（默认）
- on：开态，滑块位移 + 背景变品牌色，
aria-checked="true" - disabled：置灰且不可聚焦
29.5 交互与触控
- 整行（开关 + 文字）都是热区，行高不小于 44px；开关本体不可单独缩到 44px 以下
- 点击切换只需要一次触摸，不要求拖动滑块（拖动是桌面习惯，触屏误触率高）
- 切换动效是滑块位移 150ms 过渡；减少动态偏好下瞬时切换
- 关态与开态不能只靠颜色区分：滑块位置 +
aria-checked双通道 - 切换后立即触发 change 事件，不做二次确认（需要确认的场景由宿主先弹对话框）
29.6 无障碍
- 用
role="switch"+aria-checked="true|false"，而不是role="checkbox"（读屏会播报「开关」） - 承载控件是原生
button，键盘可聚焦、空格/回车可切换，并有可见焦点环 - 文字标签在控件内部，读屏播报的名称就是标签本身；无标签时用
label属性补aria-label - 禁用态用原生
disabled，读屏会播报不可用
29.7 doNotInvent
- 二次确认弹窗与「切换失败回滚」的业务流程
- 三态开关（关 / 开 / 待定）的视觉表达
- 与表单一起提交时的隐藏字段（由宿主添加）
29.8 unknowns
- 开关本体是否允许小于 48×28（紧凑表单的下限）
- 文案与开关的间距是否跟随字号
- 加载态（切换请求进行中）如何表达