# @getflip/swirl-tokens 中文文档

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

版本：2\.14\.3
npm 元数据更新时间：2026-05-19T12:03:39.264Z
中文译文更新时间：2026-11-16T06:04:13.843Z
软件包许可：SEE LICENSE IN LICENSE\.md

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

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

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

- 包体积（解压后）：777 kB，16 个文件
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2022-08-10T12:27:18.308Z
- 最新版本发布：2026-05-19T12:03:38.750Z
- 近 30 天下载量：18816（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：41（近 12 个月 15 个）

## 中文简介

螺旋设计系统 为Web和Mobile提供多个不同格式的Tokens软件包.

## 安装

```sh
npm install @getflip/swirl-tokens
```

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

## README

# 旋转托肯斯

使用设计系统颜色时,通常会先使用色调色板 由100到900个数值组成,如绿色600。 这些值是静态的 他们不能。 在斯维尔 我们故意跳过这个核心层 与语义色彩符号合作.

语义色彩符号不仅代表了颜色值,还代表了语义角色 它用来。 通过给颜色分配语义角色,我们实现了可预测的 主题和暗模式支持.

我们使用通用的名称 颜色符号, 这意味着颜色名称不 依赖我们的组成部分库存。 这样您就可以使用 同样的颜色符号,它们仍然会自动支持它们 阴暗模式 .

## 安装

```bash
npm install @getflip/swirl-tokens
```

## 使用量

#### 贾森

访问所有可用的符号组

-   [JSON 令牌列表](https://unpkg.com/browse/@getflip/swirl-tokens/dist/styles.light.json)

```js
import styles from "@getflip/swirl-tokens/dist/styles.json";

console.log("background-default", styles["background-default"]);
```

#### 支助科

导入所有 Css 变量 。 CSS 变量的前缀为 `--s`

-   [CSS-海关-财产列表](https://unpkg.com/browse/@getflip/swirl-tokens/dist/css/styles.light.custom-properties.css)

```css
@import "@getflip/swirl-tokens/dist/css/styles.custom-properties.css";

div {
  background-color: var(--s-background-default);
}
```

#### 常设委员会

-   [SCSS变量列表](https://unpkg.com/browse/@getflip/swirl-tokens/dist/scss/styles.light.scss)

#### 减

-   [减变量列表](https://unpkg.com/browse/@getflip/swirl-tokens/dist/less/styles.light.less)

## 常见问题

### @getflip/swirl-tokens 是什么？

螺旋设计系统 为Web和Mobile提供多个不同格式的Tokens软件包\.

### 如何安装 @getflip/swirl-tokens？

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

### @getflip/swirl-tokens 支持 TypeScript 吗？

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

### @getflip/swirl-tokens 可以商用吗？

@getflip/swirl-tokens 使用 SEE LICENSE IN LICENSE\.md 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @getflip/swirl-tokens 的下载量有多少？

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

### @getflip/swirl-tokens 还在维护吗？

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

