@freenow/wave

中文文档
2.68.1发布于 2026/11/11Apache-2.0TypeScriptESM + CJS构建来源已验证近 30 天下载 2707

为您的前端项目执行波浪设计系统

中文使用文档
文档目录6 节
  1. 文档
  2. 安装
  3. 开始
  4. 捐款
  5. 有疑问吗?
  6. 贡献者

挥手

Build Status version All Contributors

文档

我们的文献网站住在 https://wave.free-now.com/ 页面存档备份,存于互联网档案馆您可以找到详细的文件 开始,所有组件,我们的主题,我们的原则,等等.

安装

npm install @freenow/wave

或者说

yarn add @freenow/wave

开始

在将"波"作为依赖性安装后,有一些额外的步骤来让样式到位:

  • 确保安装对等依赖(包括样式组件)
  • 请检查date=中的日期值 (帮助) 请检查date=中的日期值 (帮助) 是否没有先前存在的全局样式,这些样式可能与组件所运出的样式相上下下下相上下相上下相上下相上下相下相上相下相下相上相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相上相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相下相 a { color: #ffeeaa }(中文(简体) )
  • 确保将想要的色彩方案组件添加到您的 React 树上, 以便让 CSS 变量加载( R)更多细节(中文(简体) )
import { ModernColors } from '@freenow/wave'; // blue primary color

ReactDOM.createRoot(document.getElementById('root')!).render(
    <React.StrictMode>
        <ModernColors />
        <App />
    </React.StrictMode>
);

捐款

谢谢你愿意捐款! 请读一下 捐款额 医生

有疑问吗?

请不要犹豫,让我们知道你的疑问是什么,有什么可以改进的,或者你很难从文件中得到什么. 打开问题开始对话!

贡献者

感谢这些伟大的人emoji 密钥:

Nikolai Lopin
尼古拉·洛平

💻 📖 🐛 👀
Jonah Möller
乔纳·默勒

💻 📖 🐛 👀
Luka Hartwig
卢卡·哈特维希

💻 📖 🐛 👀
Alexis Duran
亚历克西斯·杜兰

💻 📖 🐛 👀
Leonardo
莱昂纳多

💻 📖 🐛 👀
Artur Miglio
阿图尔·米廖

📖 💻 🐛
Phillip Barkmann
菲利普·巴克曼

💻
Lloyd Francis
劳埃德·弗朗西斯

📖 💻
Jan Hamara
扬·哈马拉

💻 📖 👀
rafael-sepeda
拉斐尔-塞佩达

🎨 📝
martimalek
马提马莱克

💻 📖 🐛 👀
Elena Rashkovan
埃琳娜·拉什克万

💻

本项目遵循 全部贡献者 规格。 任何捐款都欢迎!

版本与发布记录

@freenow/wave 共发布 239 个版本,首次发布于 2021/05/03;过去 12 个月发布了 29 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.68.1latest2026/11/114 天前
2.68.02026/11/0411 天前
2.67.12026/10/2719 天前
2.67.02026/10/2719 天前
3.0.0-rc.1next2026/10/141 个月前
2.66.02026/08/312 个月前

其他发布通道:rc → 2.6.0-rc.7,release-1.34.x → 1.34.8,esm.0 → 2.25.2-esm.0,preview → 2.30.2-preview.0,next → 3.0.0-rc.1。

关于 @freenow/wave 的常见问题

@freenow/wave 是什么?

为您的前端项目执行波浪设计系统

如何安装 @freenow/wave?

在项目目录运行 npm install @freenow/wave,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^18.2.0)、react-dom(^18.2.0)、styled-components(>4.3)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。它还提供命令行工具 run_v2_migration,可以用 npx run_v2_migration 直接运行。

@freenow/wave 支持 TypeScript 吗?

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

@freenow/wave 支持 ESM 还是 CommonJS?

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

@freenow/wave 可以商用吗?

@freenow/wave 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@freenow/wave 的下载量有多少?

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

@freenow/wave 还在维护吗?

最新版本 2.68.1 发布于 2026/11/11(4 天前);至今共发布 239 个版本,其中过去 12 个月发布了 29 个;首次发布于 2021/05/03。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。