@equinor/fusion-wc-ripple

中文文档

1.2.4发布于 2026/08/12ISCTypeScriptCommonJS构建来源已验证近 30 天下载 4482

## `fusion-wc-ripple` [![Published on npm](https://img.shields.io/npm/v/@equinor/fusion-wc-ripple.svg)](https://www.npmjs.com/package/@equinor/fusion-wc-ripple)

文档目录5 节

fusion-wc-ripple
Installation
Ripple <fwc-ripple>
Properties/Attributes
Methods

`fusion-wc-ripple`

Storybook

Installation

npm install @equinor/fusion-wc-ripple

Ripple `<fwc-ripple>`

Properties/Attributes

Name	Type	Default	Description
`primary`	`boolean`	`false`	When true, sets the ripple color to `--mdc-theme-primary`. Will be overridden by `--mdc-ripple-color` if set.
`accent`	`boolean`	`false`	When true, sets the ripple color to `--mdc-theme-secondary`. Will be overridden by `--mdc-ripple-color` if set.
`unbounded`	`boolean`	`false`	When true, the ripple will flow outside the component in a circle.
`activated`	`boolean`	`false`	Set true when the container of the ripple should be in an `activated` state.
`selected`	`boolean`	`false`	Set true when the container of the ripple should be in a `selected` state.
`disabled`	`boolean`	`false`	Set true to disable the ripple when the container of the ripple is disabled.

Methods

Name	Description
`startPress(event?: Event) => void`	Begin the `press` state of the ripple. Optional `Event` will be used to determine the beginning coordinates of the ripple animation when `unbounded` is false.
`endPress() => void`	End the `press` state of the ripple.
`startFocus() => void`	Begin the `focus` state of the ripple.
`endFocus() => void`	End the `focus` state of the ripple.
`startHover() => void`	Begin the `hover` state of the ripple.
`endHover() => void`	End the `hover` state of the ripple.

版本与发布记录

@equinor/fusion-wc-ripple 共发布 31 个版本，首次发布于 2021/09/17；过去 12 个月发布了 5 个版本。最新版本附带 npm provenance 构建来源证明，可追溯到公开的 CI 构建记录。

版本	发布日期	距今
`1.2.4`latest	2026/08/12	3 个月前
`1.2.3`	2026/05/11	6 个月前
`1.2.2`	2026/05/05	6 个月前
`1.2.1`	2026/04/28	6 个月前
`1.2.0`	2026/04/20	6 个月前
`1.1.1`	2024/08/23	2 年前

其他发布通道：next → 0.2.20-next.1。

关于 @equinor/fusion-wc-ripple 的常见问题

@equinor/fusion-wc-ripple 是什么？

## `fusion-wc-ripple` [![Published on npm](https://img.shields.io/npm/v/@equinor/fusion-wc-ripple.svg)](https://www.npmjs.com/package/@equinor/fusion-wc-ripple)

如何安装 @equinor/fusion-wc-ripple？

在项目目录运行 npm install @equinor/fusion-wc-ripple，或使用 pnpm add / yarn add / bun add。

@equinor/fusion-wc-ripple 支持 TypeScript 吗？

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

@equinor/fusion-wc-ripple 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require()；在 ES Module 项目中也可以用 import 引入（Node.js 会把 module.exports 作为默认导出）。

@equinor/fusion-wc-ripple 可以商用吗？

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

@equinor/fusion-wc-ripple 的下载量有多少？

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

@equinor/fusion-wc-ripple 还在维护吗？

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