DTCG JSON: W3C Design Tokens 设计令牌格式 (2025.10)
W3C 2025.10 官方 JSON 规范($type: 'color' 与结构化 colorSpace/components/hex 对象),统一跨平台颜色语义。
| 扩展名 / 语法 | .tokens.json |
|---|---|
| MIME / 媒体类型 | application/design-tokens+json |
| 色域范围 | 广色域(P3 / 无界) |
| 可读性 | 高 |
| 感知均匀性 | 支持 |
| Alpha 透明支持 | 支持 |
| 最适合场景 | 连接 Figma、Git、Style Dictionary 与 Web/iOS/Android 的中立 Token 流水线 |
DTCG JSON
TOKENS.JSON{"brand":{"primary":{"$type":"color","$value":{"colorSpace":"oklch","components":[0.55,0.21,262],"alpha":1}}}}核心优势
- 得到 Figma、Tokens Studio、Style Dictionary 与 Penpot 共同支持的开放标准。
- 原生区分 oklch、display-p3 与 srgb 色彩空间,不再丢失广色域精度。
- 支持语义别名引用 ({color.brand.500}) 且便于 Git 代码评审对比。
局限与权衡
- 体积较扁平 Hex JSON 略冗长,需要构建工具编译为最终 CSS 或原生常量。
本地转换与检查 DTCG JSON
相关色彩工程指南
DTCG JSON 常见问题
W3C DTCG 2025.10 在颜色字段上做了哪些重大更新?
2025.10 将纯文本 Hex 升级为包含 colorSpace、components、alpha 与 hex 的结构化对象,完整容纳 OKLCH 和 Display P3。
能把旧版扁平 Hex JSON 转成 DTCG 2025.10 吗?
可以,直接使用 Colr 的 /design-tokens-converter/ 或 /css-color-extractor/ 即可在本地完成转换。