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.0 KiB
2.0 KiB
26 · 进度条 Progress
26.1 用途
把一个过程的完成度可视化(上传、审核、额度耗尽);移动端的进度多数伴随文字出现,因此百分比文案与状态色是标配而非可选,且进度变化要能被读屏播报而不只是画出来。
26.2 结构(anatomy)
progress:根元素,承载轨道与文案track:轨道,未完成部分的底色bar:已完成部分,宽度由 percentage 决定ring:环形进度的圆环轨道(type=circle 时替代 track/bar)label:百分比文案,可置于条内、条右侧或环心status:状态图标位(成功 / 失败),非进行中时显示
26.3 变体维度
type:line(线形)/circle(环形)status:normal(进行中,品牌色)/success(成功)/error(失败)labelPlacement:inside(文案在条内)/right(条右侧)/center(环心,仅 circle)
26.4 状态
- default:进行中(0 < percentage < 100)
- complete:percentage = 100,文案显示 100%
- error:失败,进度停在断点并转为错误色
- paused:暂停,条体降透明度
26.5 交互与触控
- 进度条本身不可交互、不接收点击;需要取消时由宿主在旁边放按钮
- 数值变化用 CSS 宽度过渡(240ms,
--kole-m-progress-duration),不做无限循环动画(省电且不干扰读屏) - 无动画偏好(
prefers-reduced-motion)下直接跳到目标宽度
26.6 无障碍
- 根节点
role="progressbar"+aria-valuemin="0"/aria-valuemax="100"/aria-valuenow - 文案节点
aria-hidden="true",避免与aria-valuenow重复播报 - 不确定进度(无法给出百分比)用
aria-valuetext="进行中"表达
26.7 doNotInvent
- 环形进度的线宽与半径的自适应规则(由 size 决定,不做响应式推导)
- 进度到达 100% 后的自动隐藏时机
26.8 unknowns
- 百分比是否四舍五入到整数
- 环形进度是否支持渐变描边