@flood-md/tokens

中文文档
0.2.14发布于 2026/11/15MITTypeScriptES Module零依赖构建来源已验证近 30 天下载 3284

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

中文使用文档

@ 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* 角色 ; 重复嵌入式瞄准镜的两个属性。 见 基础指南 用于支持的类型和限制.

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 共发布 17 个版本,首次发布于 2026/10/22;过去 12 个月发布了 17 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.2.14latest2026/11/15今天
0.2.132026/11/141 天前
0.2.122026/11/132 天前
0.2.112026/11/115 天前
0.2.102026/10/3115 天前
0.2.92026/10/3017 天前

关于 @flood-md/tokens 的常见问题

@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 和提交记录判断。