设计令牌

每个项目都把颜色、字体和间距保存为设计令牌，并通过 API 提供。在运行时读取它们的应用，会在新令牌发布后呈现品牌更新。

令牌是一份 W3C Design Tokens 格式的文档。每个令牌是一个有名称的值，例如 color.brand.primary。其类型包括颜色、字体族、字重、字号、行高、字间距、复合排版、间距、圆角半径、阴影和边框。按钮、卡片、布局网格、断点和动效不在其范围内。

令牌可以通过路径引用另一个令牌，因此更改一个值，就会更新所有指向它的内容。引用在令牌提供之前于服务器上解析。含有引用循环、未知引用、类型不匹配或不支持的类型的文档，在保存时会被拒绝，错误信息会指出该令牌的路径。

编辑会进入草稿，无论是在控制台中、在 designTokens 下（位于你的配置文件中）还是通过 API 进行。线上站点会继续提供最近一次发布的那一套，直到一次发行版发布该草稿。要预览未发布的令牌，请求需要携带草稿通道头，并使用持有草稿读取作用域的密钥。

GraphQL 查询会为每种令牌返回扁平、已解析的数组，另外还有 source，即供构建工具使用的原始 W3C 文档。在运行时从 API 读取令牌的应用，无需部署就能获取已发布的更改。在构建时把它们固化的应用仍然需要重新构建。

阅读详情

设计令牌指南介绍了令牌的类型、编辑它们的方式，以及草稿如何发布。