排版层级设计规范¶
用户意图¶
人们要能够快速甄别一个界面,因为标题、正文、标签、代码和辅助文本之间存在明显差异。阅读体验应在信息密集型和编辑型主题风格中始终保持舒适。
设计原则¶
- DR1 — 排版角色传达用途。 文本 MUST 使用一个层级与其功能匹配的角色,而不是任意的邻近字号。
- DR2 — 相邻角色保持可区分。 有意义的层级 MUST 来自字号、字重、位置上的可见对比,或来自刻意的组合。
- DR3 — 多行文本有阅读空间。 正文和辅助内容 MUST 保持舒适的行距与行宽。
- DR4 — 主题个性保留语义。 主题 MAY 调整比例和密度,但标题、正文、标签和辅助角色 MUST 保留其相对含义。
结构与层级¶
| 角色 | 用途 | 必需的关系 |
|---|---|---|
| 展示级或页面标题 | 建立最强的阅读地标 | 明确高于章节和正文内容 |
| 章节标题 | 在界面内组织内容 | 与页面上下文和正文都保持区别 |
| 正文 | 承载主要阅读内容 | 针对持续阅读的清晰度进行优化 |
| 标签 | 标识控件或紧凑数据项 | 与其值或控件保持关联 |
| 辅助文本 | 添加次要上下文 | 视觉上更低调,但仍可读,并能与禁用文本区分 |
| 代码或数据文本 | 保留技术或表格结构 | 保持易读,同时不借用标题的强调效果 |
状态呈现¶
加载、禁用、状态、选中和截断状态 MUST 保留文本角色的身份。状态样式不得抹平标题和正文的层级,也不得让辅助文本与不可用内容难以区分。
响应式与输入行为¶
- DR5 — 行长保持可读。 响应式布局 MUST 约束长文文本,而不是让行宽无界扩展。
- DR6 — 换行保留层级。 标签和标题 MAY 换行,但它们与受控或分组内容的关系 MUST 保持清晰。
无障碍意图¶
文本在支持的缩放级别、模式和主题设置下应保持可读。层级不应仅依赖颜色,全大写或异常字距也不应损害持续阅读。
代表性示例¶
- 页面标题、章节标题、正文段落和辅助注释在快速查看和缩放查看时仍保持可区分。
- 信息密集的仪表盘与编辑型界面使用不同的个性呈现,同时保留相同的语义角色顺序。
视觉参考¶
不包含规范性资产。在正式发布之前,应在 docs/design/assets/typography-hierarchy/ 下添加密集、编辑型、缩放和受限示例。
组件契约链接¶
此初始草稿未声明任何组件链接。
决策日志¶
仓库中的设计决策尚未批准此记录。它提炼了公共 Design Conventions wiki 中的易读性与层级意图,并未复制字阶或数值检查。
开放问题¶
- OQ1 — 比例协调。 源材料的默认比例与相邻层级方案使用了不同的比率;在正式发布之前,设计意图与审计检查需要进行协调。
- OQ2 — 参考内容。 哪些真实内容集应跨主题和宽度验证每个角色?
内容边界¶
本文件定义排版意图。它不定义字号、字重、行高值、token 名称、文本组件 API 或审计阈值。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 as/astryx