Files
aurora-admin/.design_library/kole-ui-mobile/spec/parts/_merged/mobile-link.md
T
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.3 KiB
Raw Blame History

21.1 用途

一段内联文字承载「跳转 / 打开下一级」或「触发一次轻量动作」。移动端与桌面端的差别在下划线策略:桌面端靠 hover 变色提示可点,触屏没有 hover,因此链接必须靠颜色常驻区分;默认不加下划线(正文里满屏下划线噪声大),正文段落内与条款页再加下划线。

21.2 结构(anatomy)

  • link:根元素,有 href 时是原生 a,无 href 时是原生 button(只回传事件)
  • label:链接文字,单行不换行(超长由宿主截断)
  • icon:可选尾部图标,继承链接颜色,与文字间距 4px
  • href:跳转地址;禁用时不渲染该属性(否则仍可被打开)
  • text:纯文字快捷入口,与默认插槽二选一

21.3 变体维度

  • tone:brand(默认) / default(继承父级文字色) / danger / success
  • underline:false / true
  • block:false / true(撑满容器、整行可点)

21.4 状态

  • default:常态
  • active:按下时颜色加深 + 极浅底色(移动端没有 hover)
  • disabled:置灰且不响应点击,同时移出 tab 序列
  • visited:不区分(业务型链接不标注已访问,避免用户误判状态)

21.5 交互与触控

  • 点击热区高度不小于 44px,文字可短但热区不缩水(内边距撑开)
  • 按下反馈为颜色变化,不做位移缩放(避免长按抖动)
  • 相邻链接之间至少留 8px 间距,防止误触(同时给出 16px 的更稳选择)
  • 禁用链接点击不触发事件,也不跳转

21.6 无障碍

  • 有 href 用原生 a(可聚焦、可长按复制、读屏报「链接」);无 href 用原生 button
  • 禁用链接不能用 href,且要 aria-disabled="true" + tabindex="-1"(移出 tab 序列)
  • 链接文字必须自解释,不要出现孤立的「点击这里」(读屏会脱离上下文朗读)
  • 颜色不是唯一线索:正文段落内的链接必须带下划线或图标,避免色觉障碍用户无法识别

21.7 doNotInvent

  • 外跳协议处理(tel: / mailto: / 唤起 App)
  • 已访问状态的样式
  • 链接的埋点 / 统计

21.8 unknowns

  • 一屏内链接的最大推荐数量
  • 链接与相邻文字的推荐最小间距(同时给出 8px 与 16px 两档)