# @astrouxds/tokens 中文文档

规范地址：https://npmcn.com/package/%40astrouxds/tokens/

版本：1\.14\.0
npm 元数据更新时间：2026-06-23T21:42:15.567Z
中文译文更新时间：2026-11-07T01:18:44.286Z
软件包许可：未声明

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

原始 npm 页面：https://www.npmjs.com/package/%40astrouxds/tokens
原文对照：https://npmcn.com/package/%40astrouxds/tokens/?lang=original
项目主页：https://www.astrouxds.com/
源码仓库：https://github.com/RocketCommunicationsInc/astro-design-tokens

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

- 包体积（解压后）：688 kB，165 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2022-09-26T14:10:24.818Z
- 最新版本发布：2025-02-24T15:32:18.152Z
- 近 30 天下载量：5172（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：23（近 12 个月 0 个）

## 中文简介

Astro UXDS 设计托肯斯

## 安装

```sh
npm install @astrouxds/tokens
```

也可以使用：`pnpm add @astrouxds/tokens`、`yarn add @astrouxds/tokens`、`bun add @astrouxds/tokens`

## README

# Astro UXDS 设计托肯斯

此套件包括所有 [天体XDS](https://www.astrouxds.com/) 以不同格式设计符号,供您在应用程序中消费.

## 文档

[天体设计托肯斯](https://next.astrouxds.org/design-tokens/getting-started/)

## 安装

`npm i @astrouxds/tokens`

### 结构

每个导出目标都有以下文件:

-   base. 参考。 \*
    -   所有可能的变量.
    -   在没有任何系统选项的情况下有用.
-   基础。系统
    -   有语义含义的有限变量集
    -   用于创建自定义的 UI 部件 .
-   基础. 组件。 \*
    -   特定组成部分变量
    -   用于重建已有的 Astro 组件 .

### CSS 自定义属性

`@import "node_modules/@astrouxds/tokens/dist/css/index.css";`

或者说

```css
@import "node_modules/@astrouxds/tokens/dist/css/base.reference.css";
@import "node_modules/@astrouxds/tokens/dist/css/base.system.css";
@import "node_modules/@astrouxds/tokens/dist/css/base.component.css";
```

### 轻主题类

`@import "node_modules/@astrouxds/tokens/dist/css/theme.light.css";`

A 类 `light-theme` 包括Astro轻主题的类.

### 类型

`@import "node_modules/@astrouxds/tokens/dist/css/classes/typography.css";`

应用Astro打字法的几个实用类.

### 索马里

```css
@import "node_modules/@astrouxds/tokens/dist/scss/base.reference.scss";
@import "node_modules/@astrouxds/tokens/dist/scss/base.system.scss";
@import "node_modules/@astrouxds/tokens/dist/scss/base.component.scss";
```

### SASS 地图

```css
@import "node_modules/@astrouxds/tokens/dist/scss-map-flat/base.reference.scss";
@import "node_modules/@astrouxds/tokens/dist/scss-map-flat/base.system.scss";
@import "node_modules/@astrouxds/tokens/dist/scss-map-flat/base.component.scss";
```

## 管道

```mermaid
graph TD
    A[Figma] --> B(data/tokens.json)
    B -->|Token Transformer| D["/tokens/*.json"]
    D -->|Style Dictionary| E["/dist"]
    E -->F[CSS]
    E -->G[SASS]
    E -->H[iOS]
    E -->I[JSON]
```

## 捐款

### 当地建筑

`yarn make`

## 常见问题

### @astrouxds/tokens 是什么？

Astro UXDS 设计托肯斯

### 如何安装 @astrouxds/tokens？

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

### @astrouxds/tokens 支持 TypeScript 吗？

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

### @astrouxds/tokens 支持 ESM 还是 CommonJS？

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

### @astrouxds/tokens 可以商用吗？

@astrouxds/tokens 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @astrouxds/tokens 的下载量有多少？

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

### @astrouxds/tokens 还在维护吗？

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