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/ 即可在本地完成转换。