Files
aurora-admin f1fbfc2ddb
Regression / regression (push) Canceled after 0s
feat(品牌标识): 几何 K 图标(favicon/顶栏标记/theme-color) + 并行会话成果入库
## 品牌标识(本次会话)

起因:品牌此前没有任何图形标识 —— 唯一 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 未做部分)
2026-09-21 10:05:48 +08:00

2.9 KiB
Raw Permalink Blame History

35 · 滑动选择器 Slider

35.1 用途

在一个连续区间里用一次滑动选出数值(预算上限、价格区间、音量、亮度);移动端与桌面端的关键差别是热区:轨道可视高度只有 4px,但整条轨道所在的行必须是 44px 高的热区,且按下任意位置就要跳到该处 —— 触屏上要求用户精确抓住 20px 的滑块是点不中的。

35.2 结构(anatomy)

  • slider:根元素,一行里放进「轨道热区 + 数值」
  • rail:轨道热区,44px 高的可聚焦区域,承载指针事件与锚点
  • track:轨道本体(可视 4px),承载选中段与刻度的边界
  • filled:选中段,从起点铺到滑块位置
  • thumb:滑块,位置由当前值的百分比决定;拖动中放大作为「抓住了」的反馈
  • mark:刻度点,仅 marks=with-marks 时出现(只标位置,不写文案)

35.3 变体维度

  • mode:single(单滑块)/ range(双滑块,左值不越过右值)
  • marks:with-marks(轨道上标出等分点)/ none(不标刻度)
  • showValue:true(右侧显示当前值)/ false(不显示数值)

35.4 状态

  • default:常态
  • dragging:拖动中(滑块 20px → 24px,轨道加一层浅底)
  • disabled:整条置灰且不响应,指针与键盘都不改值

35.5 交互与触控

  • 轨道热区高 44px,按下任意位置即跳到该处,随后横向拖动连续改值;不要求抓住滑块
  • 手势是「按下 + 拖动」一次连续动作,不响应长按或双击;横向分量优先,纵向滚动不被吞掉(touch-action: pan-y)
  • 取值按 step 吸附并夹在 [min, max];mode=range 时左值不越过右值、右值不越过左值
  • 拖动期间滑块放大到 24px,松手后 150ms 回弹;减少动态偏好下瞬时切换
  • 值变化立即触发 change 事件(连续回传),不做防抖;松手时才做业务提交

35.6 无障碍

  • 单滑块:轨道热区是 role="slider" 且可聚焦,写 aria-valuemin / aria-valuemax / aria-valuenow / aria-label
  • 双滑块:外层是 role="group" + aria-label,每个滑块各自持有 aria-valuenow(两条独立数值)
  • 禁用时写 aria-disabled="true",读屏会播报不可用
  • 键盘:聚焦后左右方向键按 step 步进(触屏之外的替代路径)

35.7 doNotInvent

  • 数值输入框与滑块的双向绑定(宿主自行组合 Input,本组件只回传值)
  • 刻度上的文案标注与区间高亮(只标位置,不写文案)
  • 拖动结束后的「撤销 / 重置」流程
  • 纵向滑块与圆形表盘式选择器

35.8 unknowns

  • 双滑块的最小间距是否应当是 1 个 step(当前是),还是用户可配
  • 刻度数量是否应由 step 推导(当前按 5 等分固定标点)
  • 拖动中是否要把当前值放大显示在滑块上方(气泡提示)