# @gcds-core/tokens 中文文档

规范地址：https://npmcn.com/package/%40gcds-core/tokens/

版本：1\.6\.0
npm 元数据更新时间：2026-08-10T18:52:32.153Z
中文译文更新时间：2026-11-16T00:55:53.619Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40gcds-core/tokens
原文对照：https://npmcn.com/package/%40gcds-core/tokens/?lang=original
项目主页：https://design-system.canada.ca/
源码仓库：https://github.com/cds-snc/gcds-tokens

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

- 包体积（解压后）：806 kB，122 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2026-01-28T00:55:59.833Z
- 最新版本发布：2026-08-10T18:52:31.848Z
- 近 30 天下载量：4324（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：9（近 12 个月 9 个）

## 中文简介

GC 设计系统托肯斯

## 安装

```sh
npm install @gcds-core/tokens
```

也可以使用：`pnpm add @gcds-core/tokens`、`yarn add @gcds-core/tokens`、`bun add @gcds-core/tokens`

## README

[(原始内容存档于2018-10-21). La version française suit.](https://npmcn.com/package/%40gcds-core/tokens/#readme-unit%C3%A9s-de-style-de-syst%C3%A8me-de-design-gc)  
  

# GC 设计系统托肯斯

GC 设计系统 托肯斯是设计系统最小的构件. 它们代表着对颜色、打字和间距等基本元素的设计决定,创造了一套我们的设计所依赖的选择.

托肯斯将硬码值取而代之的变量可以在整个码基中再用,这样就更容易维持并更新任何码. 我们的标志帮助我们创造了符合加拿大政府要求的一贯的视觉经验。 它们还通过建立共同语言,改善设计与发展之间的交流.  
  

## 目录

-   [工具](https://npmcn.com/package/%40gcds-core/tokens/#readme-tools)
-   [如何使用设计符号](https://npmcn.com/package/%40gcds-core/tokens/#readme-how-to-use-design-tokens)
    -   [使用我们GCDS组件或GCDS工具框架的设计标志](https://npmcn.com/package/%40gcds-core/tokens/#readme-using-design-tokens-with-our-gcds-components-or-gcds-utility-framework)
    -   [单独使用设计标志,没有我们的GCDS组件或GCDS工具框架](https://npmcn.com/package/%40gcds-core/tokens/#readme-using-design-tokens-on-their-own-without-our-gcds-components-or-gcds-utility-framework)
    -   [组件设计符号](https://npmcn.com/package/%40gcds-core/tokens/#readme-component-design-tokens)
-   [安装](https://npmcn.com/package/%40gcds-core/tokens/#readme-installation)
-   [如何捐款](https://npmcn.com/package/%40gcds-core/tokens/#readme-how-to-contribute)
-   [许可证](https://npmcn.com/package/%40gcds-core/tokens/#readme-license)

## 工具

我们正在使用 [样式词典](https://amzn.github.io/style-dictionary/#/) 来建造我们的纪念物.

* * *

## 如何使用设计符号

什么是GCDS 设计托肯斯,我可以得到什么标志? 参考我们 [我们网站上关于样式和设计标志的文档](https://design-system.canada.ca/en/styles/design-tokens/) 详细情况.

### 使用我们GCDS组件或GCDS工具框架的设计标志

如果您正在使用我们的任何GCDS组件或GCDS公用框架,并且已经导入这样的 CSS 样式表 :

```js
import '@cdssnc/gcds-components/gcds.css';
```

你已经有我们的设计标志了! 简单在您的自定义样式表中使用 :

```css
 font: var(--gcds-font-text);
 color: var(--gcds-text-primary);
 background-color: var(--gcds-bg-white);
```

### 单独使用设计标志,没有我们的GCDS组件或GCDS工具框架

如果您想单独使用设计符, 不需要我们的GCDS组件或GCDS工具框架

#### 安装 GCDS 托肯斯( 设计托肯斯)

导航到您的工程的根文件夹并运行 :

```
npm i @gcds-core/tokens
```

#### 导入全部 GCDS 托肯

如果您正在计划使用组件、 全局和基准符号, 选择包含所有 GCDS 符号 。 通过导入 CSS 将所有GCDS 符号添加到您的 CSS `tokens.css` 文件 :

```css
<!-- GC Design System Tokens -->
@import 'path/to/node_modules/@gcds-core/tokens/build/web/css/tokens.css'
```

在您的 SCSS 中导入所有 GCDS 令牌 `tokens.scss` 文件 :

```css
<!-- GC Design System Tokens -->
@import 'path/to/node_modules/@gcds-core/tokens/build/web/scss/tokens.scss'
```

#### 导入 GCDS 组件符号

选择只包含 GCDS 组件令牌, 前提是您只计划使用组件特定令牌 。 通过导入特定组件的 CSS 文件,将GCDS 组件特定符号添加到您的 CSS 中。 例如,为 `gcds-button` 通过导入 `button.css` 文件 :

```css
<!-- GC Design System Tokens -->
@import 'path/to/node_modules/@gcds-core/tokens/build/web/css/components/button.css'
```

在您的 SCSS 中添加组件符号 `gcds-button` 通过导入 `button.scss` 文件 :

```css
<!-- GC Design System Tokens -->
@import 'path/to/node_modules/@gcds-core/tokens/build/web/scss/components/button.scss'
```

重复您想要包含的每个组件特定 CSS 或 SCSS 文件的上一步 。 或者通过导入 CSS 来包含您 CSS 中的所有组件特定符号 `components.css` 文件 :

```css
<!-- GC Design System Tokens -->
@import 'path/to/node_modules/@gcds-core/tokens/build/web/css/components.css'
```

通过导入 SCSS 来添加全部组件符号 `components.scss` 文件 :

```css
<!-- GC Design System Tokens -->
@import 'path/to/node_modules/@gcds-core/tokens/build/web/scss/components.scss'
```

#### 导入 GCDS 全球和基数

选择只包含 GCDS 全局和基符, 如果您不需要特定组件的符号 。 通过导入 GCDS 全局和基数符号到您的 CSS 中 `base.css` 财务报告和审定财务报表 `global.css` 文件 :

```css
<!-- GC Design System Tokens -->
@import 'path/to/node_modules/@gcds-core/tokens/build/web/css/base.css'
@import 'path/to/node_modules/@gcds-core/tokens/build/web/css/global.css'
```

通过导入 SCSS 来添加 GCDS 全局和基准符 `base.scss` 财务报告和审定财务报表 `global.scss` 文件 :

```css
<!-- GC Design System Tokens -->
@import 'path/to/node_modules/@gcds-core/tokens/build/web/scss/base.scss'
@import 'path/to/node_modules/@gcds-core/tokens/build/web/scss/global.scss'
```

### 组件设计符号

GC Design System 组件有自己的代号. 这些组件符号是特定组件的. 在别处使用会给你带来麻烦.

当被滥用的组件符号可以出乎意料地改变时. 他们随时会收到更新 任何他们被附加的组件更新.

* * *

## 安装

-   清除还原 `git clone https://github.com/cds-snc/gcds-tokens`。 。 。 .
-   运行 `npm install` 以安装所有 Node.js 依赖.
-   运行 `npm run build` 用来建造代币.

* * *

## 如何捐款

如果您有兴趣为GC设计系统Tokens做出贡献,请阅读我们 [提供指南](https://github.com/cds-snc/gcds-tokens/blob/main/CONTRIBUTING.md)。 。 。 .  
  

* * *

## 许可证

代码根据 [MIT 许可证](https://github.com/cds-snc/gcds-tokens/blob/main/LICENSE)。 。 。 .  
  

# \-- ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

# 设计风格统一组织

设计时的风格单位 基础概念、文字、空间、通用语言、通用语言、语言、语言、语言、语言、语言、语言、语言、语言、语言、语言、语言、语言、语言、语言、语言、语言、语言、语言、语言、语言、语言等等.

以“travers l'entretien and la misse à jour de n'importe quel code”为基本规范的“tréutilisées à travers l'entretien and la mise à jour de n'importe quel code”为主的样式重置单位.

(原始内容存档于2018-09-26) (英语). Nos unités de style contribuent à créer une expérence visuelle universione qui satisfait aux exigns du Government du Canada. 设计与发展交流中心.  
  

## 目录 \[FR\]

-   [外销](https://npmcn.com/package/%40gcds-core/tokens/#readme-outils)
-   [风格单位评论员](https://npmcn.com/package/%40gcds-core/tokens/#readme-comment-utiliser-les-unit%C3%A9s-de-style)
    -   [使用设计实用干部系统](https://npmcn.com/package/%40gcds-core/tokens/#readme-utilisation-des-unit%C3%A9s-de-style-avec-les-composants-ou-le-cadre-utilitaire-de-syst%C3%A8me-de-design-gc)
    -   [使用设计实用干部系统](https://npmcn.com/package/%40gcds-core/tokens/#readme-utilisation-des-unit%C3%A9s-de-style-sans-les-composants-ou-le-cadre-utilitaire-de-syst%C3%A8me-de-design-gc)
    -   [建筑风格统一](https://npmcn.com/package/%40gcds-core/tokens/#readme-unit%C3%A9-de-style-de-composant)
-   [安装](https://npmcn.com/package/%40gcds-core/tokens/#readme-installation-1)
-   [Apportez votre 捐款](https://npmcn.com/package/%40gcds-core/tokens/#readme-apportez-votre-contribution)
-   [许可证](https://npmcn.com/package/%40gcds-core/tokens/#readme-licence)

* * *

## 外销

用户数 [样式词典](https://amzn.github.io/style-dictionary/#/) 风格统一.

## 风格单位评论员

GC和quelles sont celles à ma protection? -是的 -是的 -是的 Pour en savoir plus, référez - vous à notre (法语) [网站 互联网](https://systeme-design.canada.ca/fr/styles/unites-de-style/)。 。 。 .

### 使用设计实用干部系统

CSS de la façon suvante: 国家人民党

```js
import '@cdssnc/gcds-components/gcds.css';
```

阿洛斯・阿沃斯・德・阿沃斯・德・德・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・克・ Utilisez-les simplement dans vos feuilles de style personnalisées comme ceci: 简言之

```css
 font: var(--gcds-font-text);
 color: var(--gcds-text-primary);
 background-color: var(--gcds-bg-white);
```

### 使用设计实用干部系统

(c) 设计总长.

#### 安装器 GCDS Tokens(通用设计风格单位)

Naviguez juqu ' au 案卷:

```
npm i @gcds-core/tokens
```

#### 设计风格单位的进口商

Choisissez d ' inclure toutes les unités de système de discription GC si vous planifiez user les unités de styles globales and de base, ainsi que celles des composants. (原始内容存档于2018-03-25). Ajoutez toutes les unités à votre CSS en important le fichier 互联网档案馆的存檔,存档日期2013-12-02 `tokens.css` 数字 :

```css
<!-- Unités de style de Système de design GC -->
@import 'path/to/node_modules/@gcds-core/tokens/build/web/css/tokens.css'
```

Ajoutez toutes les unités à votre SCSS en important le fichier 互联网档案馆的存檔,存档日期2013-12-04 `tokens.scss` 数字 :

```css
<!-- Unités de style de Système de design GC -->
@import 'path/to/node_modules/@gcds-core/tokens/build/web/scss/tokens.scss'
```

#### 建筑设计设计风格单位进口商

Choisissez d ' inclure unités de unités de composants de système de discription GC si vous planifiez n ' utiliser que les unités de tyle propres à des composants. 互联网档案馆的存檔,存档日期2013-12-02., p. (原始内容存档于2018-10-26) (英语). Ajoutez les unités propress à un composant dans votre CSS en important le fichier CSS du composant en . 简写为Ajoutez les unités de style du composant `gcds-button` 重要时刻 `button.css` 数字 :

```css
<!-- Unités de style de Système de design GC -->
@import 'path/to/node_modules/@gcds-core/tokens/build/web/css/components/button.css'
```

建筑风格单位 `gcds-button` 重要节奏的SCSS `button.scss` 数字 :

```css
<!-- Unités de style de Système de design GC -->
@import 'path/to/node_modules/@gcds-core/tokens/build/web/scss/components/button.scss'
```

Répétez l’étape Ci-dessus pour chaque composant dont vous souhaitez inclured le fichier CSS ou SCSS. 中国植物物种信息数据库. Vous pouvez ausi ajouter toutes les unités de propress aux composants de Système de design GC à votre CSS en important le fichier (法语: `components.css` 数字 :

```css
<!-- Unités de style de Système de design GC -->
@import 'path/to/node_modules/@gcds-core/tokens/build/web/css/components.css'
```

设计方法 GC- à votre SCSS 中 重要的 fichier `components.scss` 数字 :

```css
<!-- Unités de style de Système de design GC -->
@import 'path/to/node_modules/@gcds-core/tokens/build/web/scss/components.scss'
```

#### 全球风格和基础进口商

Choisissez d ' inclure unités de système de système de disign GC si vous n'avez pas besoin d ' sunités de style propres à des composants. 互联网档案馆的存檔,存档日期2013-12-02., p. Ajoutez 全球风格和基础单位 `base.css` 页:1 `global.css` 数字 :

```css
<!-- Unités de style de Système de design GC -->
@import 'path/to/node_modules/@gcds-core/tokens/build/web/css/base.css'
@import 'path/to/node_modules/@gcds-core/tokens/build/web/css/global.css'
```

Ajoutez 全球风格和基础单位 `base.scss` 页:1 `global.scss` 数字 :

```css
<!-- Unités de style de Système de design GC -->
@import 'path/to/node_modules/@gcds-core/tokens/build/web/scss/base.scss'
@import 'path/to/node_modules/@gcds-core/tokens/build/web/scss/global.scss'
```

### 建筑风格统一

(原始内容存档于2018-10-21) (英语). Les composants de Système de design GC possèdent leurs propress unités de style. Ces unités de style sort propress aux composants. 中国植物物种信息数据库. 利用者协会.

Si elles sont 利用不正确之处,即使用 " 模拟 " 式的 " 模拟 " 式。 Elles sont miss à jour chaque fois que le composant associé est miss à jour. 爱丽丝·克·克·克·克·克·克·克·克·克·克·克·克·克·克·克·克·克·克·克·克·克·克·克·克·克·克·克·克·克·克·克·克.

* * *

## 安装

-   法语区 `git clone https://github.com/cds-snc/gcds-tokens`。 。 。 .
-   执行后 `npm install` (原始内容存档于2013-10-12) (英语). Pour sinder toutes les dépendances node.js.
-   完成,执行 `npm run build` (原始内容存档于2012-10-12). pour compresser les unités de style.

* * *

## Apportez votre 捐款

Si vous souhaitez contribuer aux unités de style de Système de design GC, veuillez lire nos (法语) (法语) [捐款指导](https://github.com/cds-snc/gcds-tokens/blob/main/CONTRIBUTING.md)。 。 。 .

* * *

## 许可证

宪法法典 [麻省理工学院许可证](https://github.com/cds-snc/gcds-tokens/blob/main/LICENSE) (安格拉斯语).

## 常见问题

### @gcds-core/tokens 是什么？

GC 设计系统托肯斯

### 如何安装 @gcds-core/tokens？

在项目目录运行 npm install @gcds-core/tokens，或使用 pnpm add / yarn add / bun add。

### @gcds-core/tokens 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/gcds-core\_\_tokens 是否存在。

### @gcds-core/tokens 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @gcds-core/tokens 可以商用吗？

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

### @gcds-core/tokens 的下载量有多少？

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

### @gcds-core/tokens 还在维护吗？

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

