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 中一目了然。

打开 DTCG JSON <-> CSS 转换器

标准 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 声明并统一格式化。
  • 纯本地解析与复制,绝不向外部传递代码库内容。

从 CSS 源码抽取设计 Token

本指南涉及的工具

相关格式

常见问题

工具还兼容旧版纯文本 Hex 的 Token JSON 吗?

兼容,Colr 的 Token 转换器同时支持旧版单字符串与 2025.10 结构化颜色对象。

DTCG 支持深色模式引用吗?

支持,语义层可通过 {color.brand.500} 等引用路径分别绑定深浅主题基础色板。

更多色彩指南