# @department-of-veterans-affairs/mobile-tokens 中文文档

规范地址：https://npmcn.com/package/%40department-of-veterans-affairs/mobile-tokens/

版本：0\.24\.0
npm 元数据更新时间：2026-09-29T19:16:18.620Z
中文译文更新时间：2026-11-12T00:08:26.581Z
软件包许可：ISC

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40department-of-veterans-affairs/mobile-tokens
原文对照：https://npmcn.com/package/%40department-of-veterans-affairs/mobile-tokens/?lang=original
项目主页：https://design.va.gov/
源码仓库：https://va.ghe.com/software/va-mobile-library

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：80.6 kB，27 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2023-08-30T16:57:02.704Z
- 最新版本发布：2026-09-29T19:16:18.406Z
- 近 30 天下载量：4647（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：84（近 12 个月 3 个）

## 中文简介

VA 设计系统移动托肯库

## 安装

```sh
npm install @department-of-veterans-affairs/mobile-tokens
```

也可以使用：`pnpm add @department-of-veterans-affairs/mobile-tokens`、`yarn add @department-of-veterans-affairs/mobile-tokens`、`bun add @department-of-veterans-affairs/mobile-tokens`

## README

# VA 移动设计系统 - Tokens 套件

Tokens软件包包含了VA移动设计库的设计符. 用这个 [样式词典](https://amzn.github.io/style-dictionary/#/) 作为构建系统,在JSON中定义我们的风格并导出到不同的格式.

## 消费者

直接消耗指使包是可选的,但建议使用. 指使套件包含用于构建设计系统组件的同一组构件,这些构件将更方便地允许屏幕内容和应用程序级自定义组件遵循设计系统的惯例,有助于保持用户经验的一致性. 还建议将符号包版本与您所利用的组件包所使用的符号版本相匹配,以确保一致性.

### 调用

简单地说,使用符号:

1.  添加 `@department-of-veterans-affairs/mobile-tokens` 通过您的软件包管理器( 如纱线) 到您的项目
2.  添加 `import { colors } from '@department-of-veterans-affairs/mobile-tokens` 用于您想要使用的文件.
3.  代码中的参考颜色: 例如. `buttonColor = colors.vadsColorGrayMedium`

### 主题

指使套件中也有光和暗的主题可用. 这些主题属于 `colors` 上面的符号,包含原始颜色,语义符号,没有 `OnLight` 或者说 `OnDark` 模式,以及仅指定浅色或暗色主题的颜色。 这个 `OnLight` 财务报告和审定财务报表 `OnDark` 模式后缀也被删除.

主题的目的是允许指定色彩符而无需指定光或暗模式,让您的主题提供者或处理者返回正确的主题. 举例来说: 与其附带条件,不如指定 `colors.vadsColorForegroundDefaultOnLight` 或者说 `colors.vadsColorForegroundDefaultOnDark` 符号,您可以使用 `theme.vadsColorForegroundDefault` 如果您的应用程序已经知道它想要使用的颜色方案 .

#### 直接使用主题符号

1.  添加 `@department-of-veterans-affairs/mobile-tokens` 通过您的软件包管理器( 如纱线) 到您的项目
2.  添加 `import { themes } from '@department-of-veterans-affairs/mobile-tokens` 用于您想要使用的文件.
3.  在代码中引用主题使用任意一种 `themes.light` 或者说 `themes.dark`

#### 使用主题钩

我们还在组件库中提供了一个钩子,它将根据用户的OS设置返回适当的光或暗主题. 用钩:

1.  添加 `@department-of-veterans-affairs/mobile-component-library` 通过您的软件包管理器( 如纱线) 到您的项目
2.  添加 `import { useTheme } from '@department-of-veterans-affairs/mobile-component-library'`
3.  根据设备当前配色方案,用钩子来获取光或暗的主题。 譬如说.

```jsx
const theme = useTheme()

const componentStyle = {
  color: theme.vadsColorForegroundDefault,
}
```

## 捐助者

根据捐款情况,关于如何开展工作的建议有所不同.

如果您正在对已有的符号进行简单的添加或更新,建议这样做 [gitHub 网页界面中](https://va.ghe.com/software/va-mobile-library/tree/main/packages/tokens/src/tokens) 通过更新相关的 src 令牌文件和 [运行针对软件包分支的 alpha 发布](https://va.ghe.com/software/va-mobile-library/actions/workflows/publish.yml) 申明: `dist/` 文件夹如预期的那样正确排列您的更新/添加符号 [国家防范机制一揽子计划](https://www.npmjs.com/package/@department-of-veterans-affairs/mobile-tokens?activeTab=versions)。 。 。 .

如果您正在贡献许多符号或者需要调整构建进程,您应该在当地设置. 见 [组件包文档中的方向](https://department-of-veterans-affairs.github.io/va-mobile-app/design/About/For%20engineers/components) 修改将目录更改为符号包的过程(`va-mobile-library/packages/tokens`)而不是组件,没有最后运行步骤作为 `tokens:build` 命令基本上是在运行符号,因为它根据构建/配置设置和符号生成输出文件夹 `src/` 文件夹.

注意: 文件夹结构和文件命名 `src/` 文件夹具有相关性,因此遵循现有结构和直接问题到 [dSVA Slack 频道](https://dsva.slack.com/archives/C01DBGX4P45)。 。 。 .

### Yarn 命令

| 命令 | 说明 |
| --- | --- |
| `tokens:build` | 将 JSON 文件在 `src/tokens` 文件夹,并按 `config.js` |

## 常见问题

### @department-of-veterans-affairs/mobile-tokens 是什么？

VA 设计系统移动托肯库

### 如何安装 @department-of-veterans-affairs/mobile-tokens？

在项目目录运行 npm install @department-of-veterans-affairs/mobile-tokens，或使用 pnpm add / yarn add / bun add。

### @department-of-veterans-affairs/mobile-tokens 支持 TypeScript 吗？

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

### @department-of-veterans-affairs/mobile-tokens 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @department-of-veterans-affairs/mobile-tokens 可以商用吗？

@department-of-veterans-affairs/mobile-tokens 使用 ISC 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @department-of-veterans-affairs/mobile-tokens 的下载量有多少？

根据 npm 官方下载统计，@department-of-veterans-affairs/mobile-tokens 在 2026/10/12 – 2026/11/10 这 30 天内被下载 4,647 次，日均约 155 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @department-of-veterans-affairs/mobile-tokens 还在维护吗？

最新版本 0\.24\.0 发布于 2026/09/30（1 个月前）；至今共发布 84 个版本，其中过去 12 个月发布了 3 个；首次发布于 2023/08/31。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。