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
38 · 分段器 Segmented
38.1 用途
在 25 个互斥选项里选一个，并让「当前选的是哪个」一眼可见（订单状态、时间范围、列表/网格视图切换）。移动端与桌面端的关键差别是没有悬停：桌面端用户把鼠标移到未选项上就能预览「这里可以点」，触屏上这个预告不存在 —— 所以选中项必须靠形态（白底滑块 + 阴影）而非色相区分，且每一项都要占满 44px 高，否则 25 个选项挤在一行时手指点不准。
38.2 结构（anatomy）
segmented：容器，浅底 + 内边距，横向排列选项；role="radiogroup"并带aria-label说明这组在选什么item：单个选项，原生button+role="radio"（整项可点、可键盘聚焦），data-value携带取值label：选项文字（可含装饰图标，图标aria-hidden由文字承担语义）
38.3 变体维度
size：default（44px 高）/small（32px 高，卡片内次级筛选用）block：false（宽度随内容）/true（占满容器且各项等分）
38.4 状态
- default：未选中（透明底 + 次级字色）
- selected：选中（
is-active—— 卡片底滑块 + 品牌字色 +aria-checked="true"） - disabled：整段置灰、不响应点击；单个选项也可单独禁用
38.5 交互与触控
- 选项切换是一次轻点：点击后该项
is-active、同组其它项复位；不响应长按、双击与拖动（横滑切换属于标签栏手势，不在本组件） - 选中态是视觉与属性的双向同步：除类名外必须同时更新
aria-checked，只改颜色不改属性会被无障碍判为缺口 - 每项热区高 ≥ 44px（
size=small时视觉 32px，但触摸命中区仍按 44px 计，纵向不留死区） - 选中项再次点击不重复触发
change（值未变不发事件，避免宿主收到同值事件后做无意义的重渲染） - 受控：组件不存值，只回传目标值
change；宿主不采纳时视觉不变化 - 切换动效 120ms（
--kole-duration-fast），prefers-reduced-motion下瞬时切换
38.6 无障碍
- 容器
role="radiogroup"+aria-label；每个选项原生button+role="radio"+aria-checked - 选项名称由文字承担；装饰性图标必须
aria-hidden="true" - 禁用时容器补
aria-disabled="true"，选项用原生disabled（读屏播报不可用，且不进 Tab 序列） - 键盘：Tab 进入分组，左右方向键在选项间移动并选中（原生 radio 组的键盘约定）
38.7 doNotInvent
- 多选（同时选中多个）—— 需要多选时改用标签组或多选框
- 选项的横向滚动、换行与「更多」折叠（超过 5 个应换组件）
- 选中项的下划线滑块动画（那是标签栏的视觉语言，不是分段器）
- 选项禁用条件与业务权限的判断
38.8 unknowns
- 选项数量上限是否应硬约束在 5 个（当前只写建议，不做运行时拦截）
size=small的命中区是否需要在纵向自动补到 44px（当前靠--kole-m-hit-slack思路，未在样式中强制）- 是否需要「滑动经过即选中」（当前只认轻点，滑动不选中）