视觉设计 是做什么的?
每个屏幕之下的系统:色彩、排版、间距、形状、深度和动效的令牌,以及基于它们构建的组件规范。designer 技能将该系统应用于实际页面。一次构建系统;让页面充分使用它。
最关键的规则
- 在任何令牌之前,先用文字阐明设计方向。 三到四句话:为谁设计,应该给人什么感觉,绝对不能给人什么感觉,以及从主题中借鉴的一点什么东西。每个令牌决策都需对照该段落进行检查。
- 组件引用语义令牌,而非原始值。 使用
--color-text-primary,而不是--grey-900。深色模式、主题化和品牌重塑随后只需重新映射,无需重写。 - 检查每个实际颜色对在两个主题中的对比度,对照下表。在白色背景上通过测试的调色板,在其自身的着色表面上可能失败。
- 默认值不是决策。 框架灰、所有元素使用Inter字体、每个盒子4px圆角:每个看起来还行,但放在一起就像其他所有产品。决定每个值或有意接受它。
- 每个组件规范列出所有状态:默认、悬停、聚焦、活跃、禁用、加载、错误以及适用时的已选状态。缺失的状态会在构建时被不一致地发明出来。
- 更少的值,一致使用。 一个包含6步并处处使用的比例,优于一个包含14步却随意使用的比例。
何时不使用
- 安排特定页面、选择折叠线以上的内容、评审屏幕或进行重新设计:使用
designer。 - 生成插图、图标、英雄图片或品牌标志:使用
artist。 - 图表和数据可视化调色板:查看
frontend技能的references/charts.md。分类图表颜色有品牌调色板所不具备的约束。 - 在框架中实现令牌:使用
frontend。
构建顺序
每一层依赖于前一层:
- 方向段落。
- 色彩:原始值,然后语义令牌。
- 排版:字体,然后比例和角色。
- 间距比例和网格。
- 圆角、边框和高度。
- 动效令牌。
- 组件令牌和组件规范。
色彩
结构:
原始值(原始值,每个色相一条梯度,例如 50, 100 ... 900, 950):
--blue-600: oklch(0.55 0.17 255)
语义令牌(引用原始值,按职责命名):
--color-bg, --color-surface, --color-surface-raised
--color-text, --color-text-muted, --color-text-on-accent
--color-accent, --color-accent-hover
--color-border, --color-focus-ring
--color-danger, --color-success, --color-warning(每个都带有文本安全的变体)
区分经过深思熟虑的调色板与默认调色板的规则:
- 在OKLCH空间中构建梯度。 亮度在各色相之间感知均匀,因此600蓝色和600绿色具有相同的视觉重量。HSL亮度会误导。
- 为中性色着色。 纯灰色和纯黑色或白色看起来缺乏归属感。添加少量色度(约0.005至0.015)偏向品牌色相。
- 彩色表面上的文本 使用该表面色相的深色色阶,而非中性灰。灰色在彩色上看起来褪色。
- 选择一个承诺水平并坚持执行:克制(中性底色,一种强调色)、承诺(品牌色相无处不在)、全调色板、或浸入(品牌色相作为底色)。一半的承诺读作优柔寡断。
- 决不让颜色单独传达含义。 将其与图标、标签或图案配对。
- 注意当前的习惯反应。 暖奶油色页面搭配衬线展示字体和陶土色强调色,或近黑色搭配一种酸性强调色,是当没有做出决策时生成的设计会本能地采用的方案。仅在方向段落要求时才使用它们。
对比度 (WCAG 2.2)
| 配对 | AA | AAA |
|---|---|---|
| 正文文本(小于大号尺寸) | 4.5:1 | 7:1 |
| 大号文本:24px 常规,或约 18.7px 粗体及以上 | 3:1 | 4.5:1 |
| UI 组件边界、图标、焦点指示器、传达含义的图表标记 | 3:1 | 无 |
- 向用户传达任何信息的占位符文本属于文本:4.5:1。
- 禁用控件豁免,但用户仍必须能看见该控件存在。
- 测量计算后的颜色,包括透明度与叠加效果。在着色卡片上的60%不透明度标签是一种新颜色。
排版
- 根据内容基调选择字体,而非凭习惯。三种角色:一种有特色的展示字体,谨慎使用;一种舒适的正文字体;一种实用字体用于标签、说明和数据(表格中的数字使用表格数字)。
- 配对时要有明显对比(衬线配无衬线,几何配人文主义)或使用同一家族的不同字重。两种相似但不完全相同的字体读起来像是错误。
- 模块化比例。 选择一个比例:1.2用于密集的产品UI,1.25至1.333用于内容和营销。命名角色,而非尺寸:
display、h1到h4、body-lg、body、body-sm、label、caption。 - 行长 正文文本60到75个字符(
max-width: 70ch)。 - 展示字体 使用更紧的字间距(约
-0.02em到-0.04em)和尺寸上限(通过clamp()大约6rem)。更大的尺寸很少读起来像是故意的。 - 标题使用
text-wrap: balance,正文使用text-wrap: pretty。 - 行高:正文约1.5,展示字体1.1到1.25。
间距、形状、深度
- 间距比例 基于4或8的基数:例如 4, 8, 12, 16, 24, 32, 48, 64。组件使用令牌,从不使用原始像素值。
- 圆角:两到三个值,并辅以规则说明何时应用于何处。嵌套圆角:内圆角等于外圆角减去它们之间的内边距。
- 高度:三到四个级别,每个与一个职责绑定(静态卡片、下拉菜单、模态框)。在深色主题中,使用更亮的表面而非更重的阴影来提升高度。
动效
- 令牌:持续时长(例如 120ms, 200ms, 320ms)和两到三条缓动曲线(一条用于进入,一条更陡峭的用于退出)。元素重复使用它们;没有人选择每个元素的值。
- 动效解释变化:某物从何而来,什么做出了响应。仅为装饰的动效看起来像是生成的。
- 一次精心编排的瞬间胜过所有东西同时淡入。
- 尊重
prefers-reduced-motion: reduce:移除移动和长过渡,保留透明度变化。 - 悬停时不要缩放图片。为容器添加动画(阴影、边框、背景)。
深色模式
- 深色主题是语义令牌的重新映射,绝不是反转。使用深灰色作为底色,而非纯黑色,并降低会发光强调色的色度。
- 在深色主题中重新检查每个对比度对。
- 防止错误主题闪烁:在文档头部,首次绘制之前的一个小型内联脚本中决定主题。
在实现深色模式的主题切换、持久性或图像时,请阅读 references/dark-mode.md。
组件规范
在编写组件规范之前,请阅读 references/component-spec.md。它包含模板和状态清单。
常见陷阱
- 11个色阶命名为100到900。 那是9个步骤。命名梯度时,让数量与名称一致(50, 100 ... 900, 950 给出了11个)。
- “大号文本”指18点,而不是18像素。 18px常规正文文本需要4.5:1,而不是3:1。大号文本阈值是24px常规或约18.7px粗体。
- 组件中的原始令牌。 有效直到第一个主题。然后每个组件都需要编辑。
- 在模型上检查对比度,而不是在构建产物上。 透明度、叠加和抗锯齿会改变实际颜色。测量渲染后的像素或计算后的样式。
- 一次全局调整来解决局部问题。 变暗整个调色板来挽救一个失败的配对会改变所有其他配对。修复该配对的令牌。
- 没人使用的令牌,或没人令牌化的原始值。 都说明系统和构建已脱节。在构建产物中搜索原始十六进制和像素值。
- 为一个标题加载新字体。 每种字体都耗费加载时间。使用系统已加载的字体。
验证
- 已编写方向段落,并且每个令牌系列都可追溯至该段落。
- 每个文本和UI配对在浅色和深色模式下均通过AA标准,并在构建好的页面上测量。
- 组件仅使用语义令牌:搜索显示组件代码中没有原始颜色或间距值。
- 每个组件规范列出其所有状态。
- 已测试减少动效设置:无移动效果保留。
- 在硬刷新且系统设置相反的情况下,主题切换无闪烁。