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.4 KiB
3.4 KiB
44 · 级联选择器 Cascader
44.1 用途
在有层级关系的选项里逐级选到末级（省 → 市 → 区、品类 → 子品类 → SKU），移动端与桌面端的最大差别是没有横向空间：桌面上三列并排一眼就能看到全路径，375px 宽的手机上并排三列每列只剩 100px 出头，文字全部折行不可读。因此移动端一次只展示当前一层，已选路径收进上方路径条，靠路径条回退而不是靠「上一级」按钮 —— 那会多一次点击。
44.2 结构（anatomy）
cascader：根元素，mode=panel时内嵌在页面里，mode=popup时是底部浮层mask：遮罩（仅mode=popup），点击关闭cascader__header：取消 / 标题 / 确定三格（仅mode=popup）cascader__path：路径条，按已选深度渲染；除末位外都可点，点了回退到该级cascader__panel：选项区，role="listbox"+aria-label说明当前在选第几级、选什么cascader__option：单个选项，role="option"+aria-selected；有下级显示›，叶子显示✓
44.3 变体维度
mode：panel（内嵌在页面里）/popup（底部浮层，自带遮罩与确定取消）showPath：true（显示路径条，可回退）/false（不显示，层级少的场景省一行高度）round：false（直角）/true（浮层靠内容一侧切圆角）
44.4 状态
- default：常态（停在根级）
- selected：当前路径上的项，
is-selected与aria-selected="true"同步 - open / closed：仅
mode=popup，浮层展开 / 收起（收起时遮罩pointer-events: none） - disabled：整块或单个结点置灰且不响应，
aria-disabled="true" - empty：当前级没有可选项时显示占位文案
44.5 交互与触控
- 点某一级后下一级选项随之变化：面板始终只渲染当前一层，选择即下钻
- 点路径条里的上级可回退：回退到该级并重新展示它的下一级；末位是「你在这里」的锚点，不可点
- 级数不写死：路径条按已选深度渲染，两级与四级用同一份实现
- 点到叶子结点后再点同级另一项，会截断更深的层级（改选不会留下旧的深层残留）
- 选项行高与路径条各项热区均不小于 44px；选项区滚动容器
-webkit-overflow-scrolling: touch
44.6 无障碍
mode=panel根元素role="group"+aria-label；mode=popup根元素role="dialog"+aria-modal="true"- 选项区
role="listbox"，aria-label随层级变化（如「级联选项 · 城市」），读屏能播报当前在第几级 - 选项
role="option"+aria-selected；禁用项写aria-disabled="true" - 路径条末位写
aria-current="true"，读屏播报「当前项」 - 路径条每一项是原生
button（键盘可达），末位用disabled让键盘跳过
44.7 doNotInvent
- 层级数据源（由宿主传入
options树，本组件不发明省市区库） - 搜索定位某级选项（那需要把整棵树拍平，是独立的检索组件）
- 异步逐级加载的占位与重试流程
- 多选（一次选多条路径）
44.8 unknowns
- 路径很长时路径条是折行还是横向滚动（当前折行，四级以上会占两行）
- 叶子被选中后是否要自动收起浮层（当前不自动收，等宿主决定）
- 是否要保留「上一级」按钮作为路径条之外的第二种回退入口