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 未做部分）
1.8 KiB
1.8 KiB
23 · 头像 Avatar
23.1 用途
用一张图或一两个字符代表一个主体（用户、企业、群组）；移动端列表与详情页里大量出现，必须能单手扫读，因此尺寸只有三档、形状只有两种，且图片不可用时必须立刻退回文字，不能出现裂图。
23.2 结构（anatomy）
avatar：根元素，正方形圆角容器，尺寸由 size 决定image：图片，铺满容器并按形状裁切text：文字内容（姓名首字或简称），图片缺失时它就是主体fallback：兜底节点，图片加载失败后退回的形状（文字或图标）badge：可选右下角角标位，挂在线状态或未读数
23.3 变体维度
size：small（32px）/default（40px）/large（56px）shape：circle（圆形，用于人）/square（圆角方形，用于企业或群组）type：text（文字头像）/image（图片头像，失败退文字）
23.4 状态
- default：常态
- fallback：图片加载失败，退回文字或图标
- disabled：置灰（如成员已离职）
23.5 交互与触控
- 头像本身不是按钮；可点时必须由宿主包一层原生
button或a，热区不小于 44×44 - 图片
alt或根节点aria-label必填其一，读屏读「姓名 + 头像」 - 图片加载失败只触发一次
error事件，是否替换资源由宿主决定
23.6 无障碍
- 文字头像根节点
role="img"并带aria-label（内容为姓名） - 图片头像直接用
<img alt>，alt为空时视为装饰并对读屏隐藏 - 角标不改变头像的可访问名
23.7 doNotInvent
- 图片裁剪的 focal point（人脸居中）算法
- 角标位置随形状（圆 / 方）的微调规则
23.8 unknowns
- 文字头像的底色是否按名字散列取多色
- 姓名超过两个汉字时的截断规则