设计令牌 是做什么的?
一组少量但贯穿始终的命名值,是让网站看起来经过设计而非拼凑而成的关键。在定义组件之前先定义令牌;之后要更改品牌,只需编辑一个代码块即可。
应该问什么
一个品牌颜色(或一个描述情绪的词语)、浅色或深色基底,以及整体风格(企业、活泼、编辑、技术)。其他一切都可以推导得出。
颜色
按功能角色而非颜色名称来分配,这样品牌重塑就不需要重命名。
| 令牌 | 角色 | 经验法则 |
|---|---|---|
--bg | 页面背景 | 米白或近黑色,永远不要纯 #fff 或 #000 |
--surface | 卡片、输入框 | 比 --bg 的亮度高 2% 到 4% |
--text | 正文文本 | 在 --bg 上的对比度至少 7:1 |
--muted | 次要文本 | 在 --bg 上的对比度至少 4.5:1 |
--border | 细线 | 背景颜色混合 10-15% 的文本颜色 |
--accent | 按钮、高亮 | 品牌颜色 |
--accent-ink | --bg 上的链接和强调文本 | 品牌颜色加深(或在深色背景上变亮),直到通过 4.5:1 对比度 |
--on-accent | 强调色上的文本 | 白色或深色中通过 4.5:1 对比度的那一个 |
指导原则:
- 让中性色略微偏向强调色色调(饱和度 2% 到 6%)。纯灰色放在温暖的强调色旁边会显得格格不入。
- 强调色大约覆盖 10% 的表面。如果所有东西都被强调,那就没有重点了。
- 很少需要第二个强调色。仅在有明确含义(如成功或促销)时才添加一个。
- 对于深色模式,不要简单反转颜色。随着层级升高而提高表面亮度,并稍微降低强调色饱和度,使其不会发光。
如果 webcraft CLI 可用,请用它生成初始设置,而不是手动推导值。它会应用上述所有规则,计算每对颜色的亮度直到通过对比度检查,并单独构建深色主题:
webcraft tokens "#e4572e" --tone editorial -o tokens.css # 也可用:--base dark, --radius pill
webcraft tokens "#e4572e" --format theme-json # WordPress theme.json,包含相同值
在 MCP 客户端内部,同样的功能可通过 generate_tokens 工具实现。将输出视为初稿:凭眼睛调整,然后重新检查。
在最终确定之前检查每一对文本和背景:
webcraft contrast "#1b1b1f" "#f6f4ef"
webcraft contrast --tokens tokens.css
python scripts/contrast.py --tokens tokens.css # 无需安装的备用方案,仅支持十六进制值
第一种形式打印一对颜色的对比度比率和 WCAG 级别。第二种形式读取 CSS 文件并检查每个主题块(:root、[data-theme]、prefers-color-scheme)中的标准角色对,解析 var() 并读取十六进制、rgb()、hsl()、oklch() 和 color-mix()。失败的对比对是新网站最常见的可访问性缺陷,而且在好的显示器上视力正常的人也看不见,这就是为什么这是一个脚本,而不是靠主观判断。
排版
- 最多使用两种字体族:一种用于标题,一种用于正文。通常,单一字体族使用两种粗细效果更好。
- 通过结构对比来搭配(例如,衬线标题搭配无衬线正文,或紧凑型标题搭配常规正文),而不是两种相似的无衬线字体。
- 正文字体大小 16 到 18px,行高 1.5 到 1.7,行长度 60 到 75 个字符。
- 展示型字体:行高 0.95 到 1.1,字间距随尺寸增大而减小。
- 使用
clamp()实现流式缩放,这样在不同断点之间不会有跳跃:
:root {
--step--1: clamp(0.83rem, 0.8rem + 0.15vw, 0.9rem);
--step-0: clamp(1rem, 0.95rem + 0.25vw, 1.125rem);
--step-1: clamp(1.25rem, 1.1rem + 0.6vw, 1.6rem);
--step-2: clamp(1.6rem, 1.3rem + 1.3vw, 2.4rem);
--step-3: clamp(2rem, 1.5rem + 2.6vw, 3.6rem);
--step-4: clamp(2.5rem, 1.6rem + 4.6vw, 5.5rem);
--step-5: clamp(3rem, 1.5rem + 7vw, 7.5rem);
}
- 使用
font-display: swap加载字体,预加载在首屏使用的一两个字体文件,如果自托管则进行子集化。
间距、圆角和阴影
:root {
--space-1: 0.25rem; --space-2: 0.5rem; --space-3: 0.75rem; --space-4: 1rem;
--space-6: 1.5rem; --space-8: 2rem; --space-12: 3rem; --space-16: 4rem;
--section: clamp(4rem, 3rem + 6vw, 9rem); /* 区块之间的垂直内边距 */
--gutter: clamp(1rem, 0.5rem + 3vw, 3rem); /* 页面两侧内边距 */
--container: 76rem;
--radius-sm: 8px; --radius: 16px; --radius-lg: 28px; --radius-pill: 999px;
--shadow: 0 1px 2px rgb(0 0 0 / .04), 0 8px 24px rgb(0 0 0 / .06);
}
- 选择一种圆角风格(锐利、柔和或药丸形)并保持一致。混合使用圆角是最快让网站显得不一致的方式。
- 区块之间的间距应明显大于区块内部的间距;这个间隙是告诉眼睛区块在哪里结束。
输出
交付一个 tokens.css 文件,包含一个 :root 块,一个可选的 [data-theme="dark"] 块,以及一个简短表格说明每个令牌在何处使用。然后陈述正文文本、次要文本和按钮文本的对比度结果。
现有网站的品牌重塑
首先将现有的硬编码值映射到角色(在 CSS 中搜索十六进制代码并统计出现次数),然后用令牌替换它们,验证视觉上没有变化,最后交换令牌的值。同时进行这两步会使回归问题无法追踪。