# @flood-md/tokens 中文文档

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

版本：0\.2\.14
npm 元数据更新时间：2026-11-15T12:29:17.419Z
中文译文更新时间：2026-11-15T13:52:11.573Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：582 kB，10 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-10-22T11:15:22.028Z
- 最新版本发布：2026-11-15T12:29:16.969Z
- 近 30 天下载量：3284（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：17（近 12 个月 17 个）

## 中文简介

洪水语义设计标志和光/暗主题.

## 安装

```sh
npm install @flood-md/tokens
```

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

## README

# @ flood-md/ tokens (英语)

输入的参考值和水灾的语义CSS作用 **6.2.14 国家**保留洪水 软件包版本对齐。 现有的0.1.1安装使用其较早的代号合同.

反应消费者导入@flood-md/ react/ styles.cs并使用FloodRoot. 仅收件 消费者输入@flood-md/tokens/foundations.cs,并设置两个属性 相同范围元素:data-flood-foundations="中性"data-flood-them="暗". 仅提供中/暗地基剖面.

0.2.11名候选人增加了基础/填充背景中性食谱。 绝对 物质颜色与继承的动作、字段、选择和 辅助性角色。 反应材料所有人确定适当的 上下文;只显示符号主机必须应用自己的范围角色映射. 见 基础指南的材料文本部分和生成的显示 凌驾于高控制食谱之上 阿尔法填充需要审查的实际数据 背景;它们本身并不确定无障碍.

出口包括./建立(类型代号),./建立.css, . . . . . 编写值 只在src/tokens.json中出现. 出品文物不得编辑.

作用包括表面/内容、主要/次要/文字行动、领域、, 选择/反馈/焦点、国际打字、相对间距/辐射、控制/icon 大小、运动和局部层顺序。 取代公共语义 -- flood- sys\* 角色 ; 重复嵌入式瞄准镜的两个属性。 见 [基础指南](https://npmcn.com/package/docs/foundations.md) 用于支持的类型和限制.

React包捆绑了Inter及其OFL许可证. 只有消费者提供 他们自己的字体设置。 0.2.3版本绘制了静态字段 容器外出语调。 字段。边界仍然是更强大的选择;安静 默认不建立 3:1 非文本对比 。 评价实际确认 和东道方构成的无障碍性.

./tokens.css和JSON保留先前的共享/光/暗合同 - 名字 - 名称 - flood - \* names. FloodRoot以外的遗产控制仍然兼容;遗产 覆盖不会自动改变单独范围的基础角色.

版本0.2.3 添加滚动条大小/ inset/ min- thumb 角色和语义拇指/ hover 颜色,将配置扩展为168个角色. 安装匹配软件包版本 .

0.2.5版本增加了25个语义角色,带来了暗相 到193个角色。 现有角色价值保持不变:

-   sys.color.accent. 内容和sys.color.loading.placehiles 单独重音文本 和加载从焦点状态和动作状态填充.
    
-   sys.color.indicator.track/fill/cent and sys.size.indicator.sm/md/lg 控制系统 捆绑指标,不借取控制或重点作用.
    
-   sys.color.action.danger. content 风格 破坏性动作独立于 验证消息和键盘焦点.
    
-   sys.size.keycap.sm/md/lg为键盘提示提供了独立的相对高度.
    
-   sys.size.container.sm/md/lg and sys.size.grid.min-items 供给相对布局界限.
    

0.2.5版本将浮动表面与模式表面相分离. 浮出物使用了这些新语义角色中的九个; 上一个符号 价值观保持不变。 浮出水面就是不透明的倒地; 平面。浮动透明、边框、浮动、选择、浮动、阴影、浮动 和效果。浮动模糊/饱和/阴影抵消/阴影-blur定义浮动 物质。 选择、 组合框、 多选择、 菜单、 Popover 和工具提示 共享; 对话框 并保留地表。覆盖。 后投放过滤是渐进增强; 减少透明度使用不透明的填充和强迫颜色使用系统颜色. 保持文本不透明,并参照实际复合背景进行评估.

版本 0.2.11 添加字段标签、组标题和对话框标题类型 角色。 。 。 它们分开组成等级,而不改变通用正文/标签角色 或主机根字体。 运行时间值只从 src/tokens.json 编译 .

## 常见问题

### @flood-md/tokens 是什么？

洪水语义设计标志和光/暗主题\.

### 如何安装 @flood-md/tokens？

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

### @flood-md/tokens 支持 TypeScript 吗？

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

### @flood-md/tokens 支持 ESM 还是 CommonJS？

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

### @flood-md/tokens 可以商用吗？

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

### @flood-md/tokens 的下载量有多少？

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

### @flood-md/tokens 还在维护吗？

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