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.7 KiB
2.7 KiB
33 · 单选框 Radio
33.1 用途
在一组互斥选项里选且只选一项（支付方式、配送时效、发票类型）；移动端与桌面端的关键差别是选中态的表达：触屏没有鼠标悬停可以预告状态，选中必须同时有形状差异（圆点内圈实心）与 aria-checked，不能只靠颜色；且整行（圆点 + 文字）都是热区，行高不小于 44px。
33.2 结构（anatomy）
group：根元素，role="radiogroup"+aria-label说明这组在选什么item：单个选项，整行都是热区（原生button+role="radio"）icon：圆点，未选中是空心环、选中是实心圆 + 内圈反色点label：选项文字，占满剩余宽度desc：可选说明行，跟在文字下方（如「需先完成企业认证」）state：选中态is-checked与aria-checked双写
33.3 变体维度
orientation：vertical（纵向排列，组内画分隔线）/horizontal（横向排列，靠间距分组）button：false（圆点 + 文字）/true（胶囊标签式，无圆点）
33.4 状态
- default：未选中（空心环）
- checked：选中（实心圆 + 内圈反色点，
aria-checked="true"） - disabled：置灰且不可聚焦，读屏播报不可用
33.5 交互与触控
- 整行（圆点 + 文字）都是热区，行高不小于 44px；横向组里每项自身也保持这个边长
- 一次触摸即选中，不需要二次确认；选中后不能再点回空值（需要清空由宿主提供额外的「清除」动作）
- 互斥由组件负责：选中一项会立即清掉同组其它项的选中态，不留下两个选中
- 切换动效是圆点内圈 150ms 缩放；减少动态偏好下瞬时切换
- 选中后立即触发 change 事件，回传该项的值
33.6 无障碍
- 组用
role="radiogroup"+aria-label说明分组名称 - 每项是原生
button+role="radio"+aria-checked（读屏会播报「单选按钮，已选中/未选中」） - 圆点与内圈是纯装饰，对读屏隐藏（
aria-hidden），语义全靠role="radio" - 禁用项用原生
disabled并补aria-disabled="true"
33.7 doNotInvent
- 「取消选中」的回到空值交互（单选的语义就是必有一项）
- 横向组自动换行的列数策略（由宿主按文案长度决定，组件只负责 flex-wrap）
- 与表单一起提交时的隐藏字段（由宿主添加）
- 选项内容的异步加载与搜索过滤
33.8 unknowns
- 横向组超过一行时是否改成纵向（当前包裹后当行处理）
- 圆点尺寸是否随字号一起放大（当前固定 20px）
desc说明行是否允许两行以上（当前单行省略）