aurora-admin/.design_library/kole-ui-mobile/spec/parts/_merged/mobile-layout.md at main

root/aurora-admin

Fork 0

Files

T

aurora-admin f1fbfc2ddb

Regression / regression (push) Canceled after 0s

Details

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.2 KiB

Raw Permalink Blame History

20 · 布局 Layout

20.1 用途

把一行内容按比例切成若干列（等分或按 12 栅格取值）。移动端屏幕窄，绝大多数场景是 2~4 等分；需要主次分栏时才用不等宽 —— 桌面端的「12 栅格 + 响应式断点」在移动端退化为「一档列数 × 可覆盖的列宽」。

20.2 结构（anatomy）

layout：行容器，display: flex + 换行，承载列间距变量
col：列，默认占满一行（flex-basis: 100%），由行级等分或列级 span 类决定实际宽度
panel：列内容的可选包壳，提供内边距与最小高度，业务也可直接放自己的卡片
gutter：列间距，四档（0 / 8 / 16 / 24），由行级类写到 CSS 变量上
span：列级权重类（12 栅格取值），可覆盖行级等分

20.3 变体维度

gutter：0 / 8 / 16 / 24
columns：0（不启用等分） / 2 / 3 / 4
align：start / center / end / stretch
wrap：true（换行） / false（不换行、横向滚动）

20.4 状态

default：常态
本组件无交互状态（纯排布，这是设计如此，不是缺失）

20.5 交互与触控

布局容器不绑点击，不设 cursor: pointer，热区始终由列内的业务元素提供
列内若是可点区域，其热区不小于 44×44（见 §19.5 与 §6.5）
gutter 由 CSS 变量承载，同一行内所有列的宽度计算共用该变量，避免手工算宽
wrap=false 时容器横向滚动，纵向页面滚动不受影响
列宽使用 flex-basis: calc(...)，窄屏下不产生横向溢出（列内文本默认 min-width: 0）

20.6 无障碍

布局是纯视觉分组：不添加 role、不添加 aria-*
不要为了布局把语义节点（列表 / 按钮）拆到不相邻的列里，否则读屏顺序会错乱
视觉顺序必须与 DOM 顺序一致（不用 order 重排）

20.7 doNotInvent

响应式断点（移动端只有一档列数，不为大屏定义断点）
列的排序 / 拖拽
栅格嵌套的层级规则

20.8 unknowns

列内推荐的最大列数（本实现提供 2 / 3 / 4 三档）
列高等分（stretch 之外的等高策略）

2.2 KiB Raw Permalink Blame History Unescape Escape