# @gentleduck/motion 中文文档

规范地址：https://npmcn.com/package/%40gentleduck/motion/

版本：1\.0\.1
npm 元数据更新时间：2026-10-12T23:11:23.509Z
中文译文更新时间：2026-11-16T04:10:07.071Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40gentleduck/motion
原文对照：https://npmcn.com/package/%40gentleduck/motion/?lang=original
项目主页：https://gentleduck.org/duck-ui
源码仓库：https://github.com/gentleeduck/gentleduck

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

- 包体积（解压后）：50.2 kB，72 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.0\.0
- 运行依赖：0 个
- peer 依赖：react ^18 \|\| ^19，motion \>=12\.0\.0，@gentleduck/variants ^1\.0\.0
- 首次发布：2025-09-03T05:55:28.002Z
- 最新版本发布：2026-10-12T23:11:23.296Z
- 近 30 天下载量：3111（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：24（近 12 个月 15 个）

## 中文简介

温柔duck/ui组件的原始运动.

## 安装

```sh
npm install @gentleduck/motion
```

也可以使用：`pnpm add @gentleduck/motion`、`yarn add @gentleduck/motion`、`bun add @gentleduck/motion`

## README

![@gentleduck/motion](https://npmcn.com/package/public/logo-dark.svg)

# @ gentleduck/ 动作

温柔duck/ui组件的原始运动.

[麻省理工学院](https://npmcn.com/package/LICENSE) - 说吧 [更改日志](https://npmcn.com/package/CHANGELOG.md) - 说吧 [捐款](https://npmcn.com/package/CONTRIBUTING.md) - 说吧 [文档](https://gentleduck.org/duck-ui)

[![npm](https://img.shields.io/npm/v/@gentleduck/motion.svg)](https://www.npmjs.com/package/@gentleduck/motion) [![downloads](https://img.shields.io/npm/dm/@gentleduck/motion.svg)](https://www.npmjs.com/package/@gentleduck/motion) [![MIT](https://img.shields.io/npm/l/@gentleduck/motion.svg)](https://npmcn.com/package/LICENSE)

* * *

动画代号,预设,并减少对温柔达克生态系统的动作支持. 可选地与动画库相融合,用于丰富的出入口动画.

## 快速启动

```bash
bun add @gentleduck/motion
```

```tsx
import { useDuckReducedMotion, motionTransition } from '@gentleduck/motion'

function Fade() {
  const reduced = useDuckReducedMotion()
  const transition = motionTransition(reduced, { duration: 200, easing: 'ease-out' })
  // ...
}
```

## 特征

-   **缓解预设** - 说吧 `duckMotionEasing.standard`, (中文(简体) ), `.exit`, (中文(简体) ), `.expo`, (中文(简体) ), `.easeOut`, (中文(简体) ), `.spring`
-   **持续日期** - 说吧 `duckMotionDurationMs.fast` (150毫秒), `.normal` (200毫米), `.slow` (300毫秒), `.exit` (180ms倒计时)
-   **春季过渡** - 说吧 `springDefault`, (中文(简体) ), `springSnappy`, (中文(简体) ), `springGentle`, (中文(简体) ), `springBouncy`, (中文(简体) ), `springStiff`, (中文(简体) ), `springSmooth`, (中文(简体) ), `springInstant`
-   **CSS 自定义属性** - 说吧 `--gentleduck-motion-dur`, (中文(简体) ), `--gentleduck-motion-ease` 通过 `@gentleduck/motion/css`
-   **减少动议** - 说吧 `useDuckReducedMotion()`, (中文(简体) ), `motionTransition()`
-   **动画预设** - 树能震动的预设 `fadeIn`, (中文(简体) ), `scaleIn`, (中文(简体) ), `slideUp` 带有模糊和不对称出口
-   **方向预设** - 说吧 `createDirectionalPreset('bottom')` 菜单/流行动画; `createSlidePreset` 纯幻灯片
-   **动议库集成** - 说吧 `MotionProvider`, (中文(简体) ), `LazyMotion` 特性加载器, `useMotionPreset` 钩子

## 出口

| 入境点 | 它提供的东西 |
| --- | --- |
| `@gentleduck/motion` | 托肯斯,放轻松,减少运动钩,CVA动画变体 |
| `@gentleduck/motion/css` | CSS 文件带有运动自定义属性并减少运动倒置 |
| `@gentleduck/motion/transitions` | 周期/已映射到运动对象、弹簧预设 |
| `@gentleduck/motion/motion-presets` | `useMotionPreset` 钩子 |
| `@gentleduck/motion/motion-features` | `loadDomAnimation`, (中文(简体) ), `loadDomMax` 懒惰运动特性加载器 |
| `@gentleduck/motion/motion-provider` | `MotionProvider` 包裹懒惰运动 + 运动配置 |
| `@gentleduck/motion/presets` | 单个可树动预设出口(`fadeIn`, (中文(简体) ), `scaleIn`页:1 |
| `@gentleduck/motion/presets/fade-in` | 用于最佳树摇动的单个预设导入 |

## 许可证

麻省理工学院

## 常见问题

### @gentleduck/motion 是什么？

温柔duck/ui组件的原始运动\.

### 如何安装 @gentleduck/motion？

在项目目录运行 npm install @gentleduck/motion，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@gentleduck/variants（^1\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @gentleduck/motion 支持 TypeScript 吗？

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

### @gentleduck/motion 支持 ESM 还是 CommonJS？

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

### @gentleduck/motion 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @gentleduck/motion 可以商用吗？

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

### @gentleduck/motion 的下载量有多少？

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

### @gentleduck/motion 还在维护吗？

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

