W3C Design Tokens (DTCG 2025.10):从 Figma 到 CSS 工程管线
详解 W3C DTCG 2025.10 JSON 规范结构($type、$value colorSpace 与 components、别名),并实现与 CSS / Tailwind v4 的无损转换。
约 6 分钟 阅读 · 更新于 2026-11-22
摘要对比
| 规范版本 | 色值表示方式 | 广色域支持 | 语义别名语法 |
|---|---|---|---|
| 旧版非标 JSON | "value": "#2563EB" | 否(仅 sRGB Hex) | 因工具而异 |
| W3C DTCG 2025.10 | "$type": "color", "$value": { colorSpace, components } | 是(oklch / display-p3) | 标准 {group.token} 引用 |
| CSS 自定义属性 | --color-brand: oklch(54.6% 0.215 262.9) | 是 | var(--color-brand) |
解析 W3C DTCG 2025.10 颜色 Token 结构
按照 2025.10 模块规定,每个颜色令牌节点声明 $type: "color"(可从父级分组继承),$value 内含明确的色彩空间标识、数值分量数组、可选 alpha 与兼容 hex。
设计工具导出 Display P3 或 OKLCH 时从此告别精度丢失。
- colorSpace 兼容 srgb、oklch、oklab、display-p3 等标准空间名。
- 花括号别名引用让亮暗主题映射在 Git 中一目了然。
标准 2025.10 Token JSON 片段示例
下面展示了同时包含 OKLCH 数值数组与兼容性 Hex 备选字段的规范格式。
标准 2025.10 Token JSON 片段示例
JSON{
"color": {
"$type": "color",
"brand": {
"primary": {
"$value": {
"colorSpace": "oklch",
"components": [0.546, 0.215, 262.9],
"alpha": 1,
"hex": "#2563eb"
}
}
}
}
}从现有 CSS 样式表反向抽取出 DTCG JSON
如果前端代码里已经沉淀了大量 :root 变量或 SCSS 色表,可直接用浏览器工具反向提取并归一化成标准 DTCG JSON,无需搭建 Node CLI。
一并导出 SwiftUI Color、Android XML 与 Tailwind 配置。
- 自动识别 Hex、RGB、HSL 与 OKLCH 声明并统一格式化。
- 纯本地解析与复制,绝不向外部传递代码库内容。
本指南涉及的工具
相关格式
常见问题
工具还兼容旧版纯文本 Hex 的 Token JSON 吗?
兼容,Colr 的 Token 转换器同时支持旧版单字符串与 2025.10 结构化颜色对象。
DTCG 支持深色模式引用吗?
支持,语义层可通过 {color.brand.500} 等引用路径分别绑定深浅主题基础色板。
更多色彩指南
- Hex 转 OKLCH:将设计 Token 平滑迁移至 Tailwind CSS v4分步讲解如何把旧版 Tailwind v3 Hex/HSL 配置升级为 CSS Color 4 @theme oklch() 色阶,获得一致亮度与 Display P3 支持。
- Adobe .ASE、.ACO、Procreate .swatches 与 GIMP .gpl 色板互转了解 Adobe .ase、Photoshop .aco、Procreate .swatches 压缩包与 GIMP .gpl 的二进制内部结构,并在浏览器本地无损互转。
- 把 CSS 十六进制透明色转成 Android ARGB将 CSS 色值末尾的透明度移到 Android 色值开头。用半透明蓝色核对字节顺序,并在黑白背景上验证结果。
- OKLCH vs HSL vs sRGB:深入理解广色域 Display P3全面对比 HSL、sRGB Hex、Display P3 与 OKLCH 的视觉亮度准确性、渐变发灰死区、色域大小及渐进增强 CSS 写法。