@atlaskit/tokens

中文文档
20.9.1发布于 2026/11/07Apache-2.0TypeScriptESM + CJS近 30 天下载 790.3万

设计符号是命名和存储设计决定的单一真理来源.

中文使用文档
文档目录4 节
  1. 安装
  2. 使用量
  3. 使用量
  4. 选项

键

Tokens是一个单一的真理来源来命名和存储Atlassian设计决定.

安装

yarn add @atlaskit/tokens

使用量

查看文档。 。 。 .

贝贝普勒金

用于优化性能和支持设计系统令牌倒置的bail插件.

它取代了任何给 @atlaskit/tokens cSS 函数值为函数值 将返回(即 var(-token-name) ) 或带有倒数的变化.

如果没有回落, 插件( 可选的) 从默认的 Atlassian 中找到符号值 ,并设定为倒置.

如果代码中定义了后退, 则插入样式( 使用 模板字符串).

使用量

将插件添加到您的 Bail 配置 :

{
  "plugins": [
    ["@atlaskit/tokens/babel-plugin", { "shouldUseAutoFallback": true }]
  ]
}

选项

目前插件支持一个选项, shouldUseAutoFallback。当未禁用时,插件 将在默认的 Atlassian 主题中获取符号值( 目前 atlassian-light)并使用该词 作为倒数值.

这对于使用符号的情况有用,但不能保证符号定义 在顶级页面CSS中显示.

版本与发布记录

@atlaskit/tokens 共发布 377 个版本,首次发布于 2021/07/02;过去 12 个月发布了 93 个版本。

版本发布日期距今
20.9.1latest2026/11/07今天
20.9.02026/11/025 天前
20.8.22026/10/2711 天前
20.8.12026/10/2711 天前
20.8.02026/10/2612 天前
20.7.02026/10/2216 天前

其他发布通道:next → 1.4.2。

关于 @atlaskit/tokens 的常见问题

@atlaskit/tokens 是什么?

设计符号是命名和存储设计决定的单一真理来源.

如何安装 @atlaskit/tokens?

在项目目录运行 npm install @atlaskit/tokens,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^18.2.0 || ^19.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@atlaskit/tokens 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@atlaskit/tokens 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@atlaskit/tokens 可以商用吗?

@atlaskit/tokens 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@atlaskit/tokens 的下载量有多少?

根据 npm 官方下载统计,@atlaskit/tokens 在 2026/10/07 – 2026/11/05 这 30 天内被下载 7,902,744 次,日均约 263,425 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@atlaskit/tokens 还在维护吗?

最新版本 20.9.1 发布于 2026/11/07(今天);至今共发布 377 个版本,其中过去 12 个月发布了 93 个;首次发布于 2021/07/02。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。