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
30 · 步进器 Stepper
30.1 用途
在一段有界区间里连续加减小整数（购买数量、份数、编号）；移动端与桌面端的关键差别是加号与减号必须各自独立占一个 44px 见方的热区，且到边界时不是把按钮藏起来，而是置灰 —— 触屏上「按钮消失」会让用户以为界面坏了，而置灰能表达「到头了」。
30.2 结构（anatomy）
stepper：根元素，一行里放进「减号 + 值 + 加号」minus：减号按钮，到达min时置灰value：值区；editable=true时是可聚焦的数字输入框，否则是纯文本plus：加号按钮，到达max时置灰unit：可选单位文案，跟在值后面（如「件」），由默认插槽给出label：无障碍分组名称（role="group"+aria-label）
30.3 变体维度
size：default（控件高 44px）/small（控件高 36px，视觉更紧凑）round：false（方角）/true（全圆角，用于购物车等轻量场合）
30.4 状态
- default：常态
- disabled：整组置灰且不可聚焦
- 边界：值等于
min时减号置灰，等于max时加号置灰（按钮仍在原位，不隐藏）
30.5 交互与触控
- 加号与减号各自是 44px 见方的热区；
size=small视觉 36px 时用--kole-m-hit-slack把热区外扩回 44px - 单击步进一个
step，不响应长按连击（长按是桌面习惯，触屏上容易多跳） - 到达
min/max时对应按钮置disabled且置灰，点击不产生值与事件 - 值变化后立即触发 change 事件，不做防抖
editable=true时值区接受键盘直接输入；非法输入（非数字、越界）在失焦时回落到边界值
30.6 无障碍
- 根元素
role="group"+aria-label说明这组控件在调什么 - 减号 / 加号是原生
button，各自的aria-label是「减少」/「增加」（不用符号代替名称） - 值区在只读态置
role="spinbutton"并写aria-valuenow/aria-valuemin/aria-valuemax - 置灰的按钮用原生
disabled，读屏会播报不可用且键盘会跳过
30.7 doNotInvent
- 长按连击、惯性加速的时值曲线
- 小数与浮点精度（本组件只处理整数；金额请用输入框 + 数字键盘）
- 超出边界的提示文案（由宿主决定是否提示）
30.8 unknowns
- 值为 0 时是否自动隐藏整个步进器（购物车场景）
- 是否需要键盘上的上下方向键加减
- 单位文案是否随语言变化