卓越排版
好的排版大多在于节制。合理的字号层级、舒适的间距和足够的对比度,胜过任何花哨的效果。标签、表格单元格、营销标题和文章段落不应共用一套规则。在构建或审查任何包含文本的内容时,请应用这些原则。
审查时,读取页面内容而非扫描代码:眯眼检查层级是否成立,通读一个完整段落以感受舒适度,并调整视口大小以观察在实际内容长度下是否出现糟糕的换行、孤行和截断。
词语本身(按钮标签、错误消息、空状态)由 better-writing 技能覆盖;语义化标题结构由 better-accessibility 覆盖;空间 RTL 布局和逻辑 CSS 属性由 better-layout 覆盖;渲染对对比度测量和颜色修复由 better-colors 覆盖。本技能负责文本在混合方向内容中如何渲染、换行及表现。
匹配项目的样式系统。 在建议或编写任何修复之前,检查代码库如何设置样式,并以该样式系统表达所有更改:在 Tailwind 项目中使用 Tailwind 工具类,在 CSS、CSS Modules、styled-components 或 StyleX 中使用纯声明。速查表 将每个声明映射到其 Tailwind 等效项。切勿仅为应用排版修复而引入第二种样式方法。
快速参考
| 类别 | 使用时机 | 参考文档 |
|---|---|---|
| 选择字体 | 字体类别、搭配、格式、字型解剖 | choosing-fonts.md |
| 可变字体与 OpenType | 轴、字重、表格数字、样式集 | variable-fonts-and-opentype.md |
| 间距与尺寸 | 字号层级、标题层级、行高、字间距、文本修剪 | spacing-and-sizing.md |
| 换行与标点 | 行长、换行、截断、智能标点、RTL | wrapping-and-punctuation.md |
| 细节与可访问性 | 下划线、选区、表单、装饰性文本、对比度 | details-and-accessibility.md |
| CSS 速查表 | 快速查找每个涉及的属性及其 Tailwind 等效项 | css-cheat-sheet.md |
核心原则
1. 提供正确的格式
在 Web 上使用 .woff2(Brotli 压缩,广泛支持)。.woff 仅作为非常老旧浏览器的备用方案;.ttf 和 .otf 是未经 Web 压缩的原始桌面格式。文件如何加载是项目自身的问题,本技能不做规定。
2. 优先使用高级属性而非原始标签
当 CSS 属性存在时,请使用它。使用 font-weight: 650 而非 font-variation-settings: "wght" 650,使用 font-optical-sizing: auto 而非 "opsz",使用 font-variant-numeric: tabular-nums 而非 font-feature-settings: "tnum" 1。这些高级属性在非可变字体回退时仍然有效。将原始标签属性保留给自定义轴("GRAD" 80)和没有对应高级属性的小众特性("ss01" 1)。
3. 加载预期的字重与字形
浏览器可能会综合生成当前字体族未提供的请求字重或字形。最好加载设计实际使用的字面。仅在验证了所有必需的粗体、斜体、小型大写、上标和下标形式在整个回退字体堆栈中保持视觉差异之后,才设置 font-synthesis: none;禁用合成并非诊断手段,不得抹除强调效果。
4. 减少字体、字号和字重的种类
极少使用超过三种字体。字重和字号定义了层级,但过度使用会迅速损害可读性。为对比而非相似而搭配:衬线标题搭配无衬线正文显得深思熟虑,两个几乎相同的无衬线字体则像是错误。在 18px 以下,保持字重在 400 及以上;低于 300 的字重仅用于展示(28px 及以上),它们在文本大小下会消失。
5. 使用带语义名称的字号层级
定义一小套字号,并尽可能少地偏离它。没有系统的硬编码字号在规模扩展时会崩溃。对于个人项目,像 text-sm 这样的默认名称只要用法规则清晰就很好用。在团队中,应按用途(text-body-sm)而非尺寸来命名字号,以保持规则一致。
6. 标题尺寸随层级递减
在连贯的页面层级中,将标题层级映射到字号层级中递减的步骤:一个视觉上从属的标题不应意外地压倒其父标题。相邻级别在层级向小端发展时可以共享一个尺寸,只要字重或间距能保持它们区分。根据 better-accessibility 选择语义化的标题元素;本技能仅控制其视觉处理。
7. 根据角色设定行高
标题更紧凑,大约 1.1。正文 1.5 到 1.6。优先使用无单位值,以便行高随字号缩放;像 24px 这样的固定值则不会。紧凑的行高适用于短文本:任何换行超过三行的文本至少需要 1.4,即使在高度受限的行中也是如此。
8. 根据尺寸设定字间距
大标题通常看起来略带负字间距效果更好。小写标签需要一点正字间距,以避免字母显得拥挤。阅读尺寸下的正文则两者都不需要。
9. 限制行长
长行使得眼睛难以找到下一行。将长文本的行长限制在大约每行 60–75 个字符。任何单位都行:65ch 直接按字符测量,而像素或 rem 限制也同样有效:在 16px 正文大小下,该范围大致落在 560px 和 680px 之间,具体取决于字体,因此 Tailwind 的 max-w-xl 或 max-w-2xl 就很合适。重要的是存在一个限制,并且最终的行长在范围之内。
10. 有目的地换行
text-wrap: balance 均匀分布文本到各行:用于标题。text-wrap: pretty 避免在最后一行只留下一个短单词:用于描述。在长格式文本中两者都跳过:浏览器无论如何都会忽略超过几行的 balance,而均匀化整个段落会浪费空间并使其更难阅读。当长单词、链接或 ID 可能溢出容器时,使用 overflow-wrap: break-word。在换行会显得破损的标签和徽章上,使用 white-space: nowrap。
11. 在变化的值上使用表格数字
默认情况下数字宽度不同,因此计时器、计数器和价格在更新时会改变布局。对任何变化的值应用 font-variant-numeric: tabular-nums。
12. 截断而不丢失内容
单行:使用 text-overflow: ellipsis 配合 overflow: hidden 和 white-space: nowrap。多行:使用 line-clamp。截断会隐藏内容,因此如果缺失的文本很重要,请在工具提示或展开视图中保留完整值。
13. 自然地编写文案,用 CSS 设置样式
以自然大小写存储文本,并用 text-transform 控制呈现,这样重新设计时永远不需要重写文案。使用智能标点:散文中使用弯引号(代码中使用直引号),表示范围如 2010–2020 使用短破折号,表示思绪转折使用长破折号,使用单个省略号字符,使用 将如 16 px 的值保持在一起,使用 ­ 控制长单词可能断开的位置。
14. 来源于字体的下划线
默认下划线由浏览器决定其位置。使用 text-underline-position: from-font 和 text-decoration-thickness: from-font 从字体自身的度量中获取位置和粗细,或使用 text-decoration-thickness、text-underline-offset 和 text-decoration-skip-ink 手动调整。text-decoration-style 将线条绘制为点线、虚线或波浪线;点线是一种常见的提示,表明单词带有额外信息,例如缩写或定义的术语。除非唯一动画的是颜色变化,否则应将下划线构建为单独的元素,而不是使用 text-decoration:颜色是真实下划线中唯一能可靠动画的部分。
15. 移动端输入框字体大小设为 16px
当 iOS Safari 中输入框的文本小于 16px 时,它会缩放整个页面。两种修复方法以不同方式将字体大小保持在 16px,因此应询问设计需要哪一种,而不是静默选择:在移动设备上放大输入框(text-base sm:text-sm),这会改变其在小屏幕上的外观;或者保持 font-size: 16px 并使用 transform: scale() 渲染预期大小,同时补偿宽度和 line-height,使设计在每个视口下都相同。两种方法。
16. 尺寸与对比度底线
长形式正文文本从接近浏览器默认的 16px 开始,然后在实际的字型、行长、平台和产品密度中进行判断。UI 文本可以更小:14px 对于输入框和菜单来说是一个有用的起点(输入框在移动端仍需 16px,参见原则 15),13px 用于说明文字,很少低于 12px。当文本看起来对比度低时,使用 better-colors 测量渲染对,使用 better-accessibility 分类需求;除非被要求,否则不要更改颜色。
17. 在根元素上应用字体平滑
在 macOS 上文本渲染得比预期更粗。在根布局上一次性地应用 -webkit-font-smoothing: antialiased 和 -moz-osx-font-smoothing: grayscale(两者都由 Tailwind 的 antialiased 覆盖),以便它们覆盖所有文本。
18. 语言与双向文本行为
设置 lang 以便浏览器和辅助技术选择正确的发音、引号和断字。在方向改变或需要保持数字顺序时在文档或内容边界设置 dir,并在需要时为隔离的混合方向值使用 <bdi>。空间镜像和逻辑 CSS 属性属于 better-layout。
19. 保持有用的文本可选
当选中的组合保持清晰易读时,::selection 可以将品牌带入阅读体验。默认保持文本可选中。仅在特定的可拖拽或手势驱动的表面上,当意外选择明显干扰交互时才使用 user-select: none;切勿跨界面禁用选择,或仅仅因为按钮标签可以被高亮而禁用。
常见错误
| 错误 | 修复 |
|---|---|
在 Web 上提供 .ttf/.otf | 转换为 .woff2 |
使用 font-variation-settings: "wght" 控制字重 | 使用 font-weight(与非可变回退兼容) |
使用 font-feature-settings: "tnum" 1 | 使用 font-variant-numeric: tabular-nums |
| 合成字形与预期设计不同 | 加载所需字面;仅禁用已验证的合成模式,不抹除强调效果 |
| 硬编码了单次使用的字号 | 使用字号层级 |
| 子标题在视觉上压倒其父标题 | 将该部分层级映射到递减的层级步骤 |
| 根据默认大小选择了标题元素 | 使用 better-accessibility 选择语义,然后在 CSS 中设置视觉大小 |
在可缩放文本上使用 line-height: 24px | 使用无单位值(1.5) |
| 全宽段落 | 限制在每行 60–75 个字符 |
| 段落最后一行出现孤行 | 使用 text-wrap: pretty |
| 两行标题不平衡 | 使用 text-wrap: balance |
| 数字导致布局移位 | 使用 tabular-nums |
| 截断文本无法阅读完整值 | 为完整值提供工具提示或展开视图 |
在文案中键入了 UPPERCASE | 使用自然大小写 + text-transform |
| 界面中使用了两端对齐文本 | 使用 text-align: start;保留两端对齐用于特定的编辑版式 |
| 下划线穿过字母下伸部分 | 使用 text-decoration-skip-ink: auto、from-font 度量 |
iOS 上低于 16px 的输入框缩放 | 先询问:使用 text-base sm:text-sm,或使用 16px 并通过 transform 缩放以保持设计尺寸 |
| 根布局缺少字体平滑 | 在根元素应用一次 antialiased |
| 混合方向值以错误顺序渲染 | 设置正确的 lang/dir;在需要时使用 <bdi> 隔离值 |
| 在应用程序界面中禁用了选择 | 恢复选择;仅在与拖拽或手势冲突的特定交互上抑制选择 |
| 额外信息提示没有视觉提示 | 通过 text-decoration-style: dotted 使用点线下划线 |
在 14px UI 文本上使用细/轻字重 | 18px 以下使用字重 400+;细字重仅用于展示 |
在三行卡片描述上使用 leading-none | 任何换行到 3 行以上的文本至少使用 1.4 |
审查输出格式
仅当用户要求进行独立的排版审查时使用此格式。当 better-interface 编排审查时,向该技能提供领域证据和发现,并让其输出格式、严重性等级、合并规则、上限和结论优先。
独立审查分为两部分呈现。
发现
将所有已确认的发现按原则分组。使用包含以下列的 Markdown 表格:严重性、位置、之前、之后和原因。绝不要使用分开的 "Before:" / "After:" 行。
- 严重性:
HIGH使文本不可读、不可用或结构上误导;MEDIUM损害层级、换行或扫描;LOW是孤立的排版改进。 - 位置:引用
path/to/file:line。如果工件没有源文件,则引用确切屏幕和组件。 - 之前 / 之后:显示当前排版以及可行的替换方案。
- 原因:指出违反的原则及其对可读性或层级的影响。
将重复的系统性问题合并为一行,并列出所有受影响的地址。省略没有发现的那些原则。
示例
表格数字
| 严重性 | 位置 | 之前 | 之后 | 原因 |
|---|---|---|---|---|
| MEDIUM | src/Price.tsx:17 | 实时价格上的 <span>{price}</span> | <span className="tabular-nums">{price}</span> | 比例数字导致变化的值移位 |
| LOW | src/numbers.css:8 | font-feature-settings: "tnum" 1 | font-variant-numeric: tabular-nums | 高级属性保留了回退行为 |
行高与行长
| 严重性 | 位置 | 之前 | 之后 | 原因 |
|---|---|---|---|---|
| MEDIUM | src/Article.tsx:33 | 正文段落上的 leading-none | leading-normal(1.5) | 正文需要宽松的行高以便在换行时保持可读性 |
| LOW | src/Content.tsx:12 | 容器没有 max-width | max-w-2xl | 未限制的行长使得长段落难以扫描 |
标点与引号
| 严重性 | 位置 | 之前 | 之后 | 原因 |
|---|---|---|---|---|
| LOW | src/Body.tsx:8 | 引号中的 '...' | 弯引号 '...' | 智能标点改善阅读体验,与所陈述的设计风格保持一致 |
总结
呈现一个简短的摘要,但仅当用户特意要求时才包含。在 better-interface 编排时,由 better-interface 决定是否包含摘要。当独立使用时,如果没有发现任何问题,则不输出任何摘要;否则,仅在【发现】之后并应要求添加摘要。