# @fluidkit/core 中文文档

规范地址：https://npmcn.com/package/%40fluidkit/core/

版本：2\.0\.0
npm 元数据更新时间：2026-11-01T19:46:14.959Z
中文译文更新时间：2026-11-15T03:01:41.291Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40fluidkit/core
原文对照：https://npmcn.com/package/%40fluidkit/core/?lang=original
项目主页：https://fluidkit.mogilnikov.dev/core
源码仓库：https://github.com/mikhailmogilnikov/fluid-kit

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

- 包体积（解压后）：734 kB，18 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-10-23T20:51:50.522Z
- 最新版本发布：2026-11-01T19:46:14.591Z
- 近 30 天下载量：2359（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：10（近 12 个月 10 个）

## 中文简介

无框架的流体克特:液态克特的玻璃,形态,指示器,拖曳,起起并布局在能保持其速度的可中断弹簧上,而苹果为CSS的弹簧和过渡.

## 安装

```sh
npm install @fluidkit/core
```

也可以使用：`pnpm add @fluidkit/core`、`yarn add @fluidkit/core`、`bun add @fluidkit/core`

## README

# @ fluidkit/ core (英语)

[流体图](https://fluidkit.mogilnikov.dev/) 液体模糊的玻璃,形态, 指示、拖放、起起和布局,在保持速度的可中断弹簧和苹果弹簧上 和过渡名,CSS也。 每个特性对任意元素都有作用; 你不导入的不是 在你的捆绑。 使用 React, Vue 或 Svelte 安装 [`@fluidkit/react`](https://www.npmjs.com/package/@fluidkit/react), (中文(简体) ), [`@fluidkit/vue`](https://www.npmjs.com/package/@fluidkit/vue) 或者说 [`@fluidkit/svelte`](https://www.npmjs.com/package/@fluidkit/svelte) 换句话说,每个人都有这些东西.

**[文档](https://fluidkit.mogilnikov.dev/)** • 妇女 [更改日志](https://npmcn.com/package/%40fluidkit/core/CHANGELOG.md)

```bash
npm install @fluidkit/core
```

导入样式表一次:玻璃,以及CSS的弹簧和过渡.

```js
import "@fluidkit/core/style.css";
```

```html
<button class="lb lb-interactive">Follow</button>
```

```js
import { createDrag, createLayout, createLift, installPress, springs, transitions } from "@fluidkit/core";

// Glass that lights up, swells and stretches under the finger
installPress();

// A sheet with snap points, let go at the finger's speed
createDrag({ element: sheet, axis: "y", snaps: () => [0, innerHeight / 2, innerHeight - 88] });

// A long press lifts the photo and opens its menu
createLift({ element: photo, menu });

// Rows put in, taken out or reordered move to their new places
createLayout({ root: list, spring: springs.snappy(), enter: transitions.blurReplace() });
```

```html
<div popover class="fk-transition fk-blur-replace fk-bouncy">…</div>
```

| 特性 | 文档 |
| --- | --- |
| 液体模糊:玻璃、压力、熔化组 | [模糊](https://fluidkit.mogilnikov.dev/blur), (中文(简体) ), [滚动边缘](https://fluidkit.mogilnikov.dev/edge) |
| 墨菲:一个元素入到另一个元素后 | [变形](https://fluidkit.mogilnikov.dev/morph) |
| 指标:任何盘旋、按住或选定的元素上方有一个元素 | [指标](https://fluidkit.mogilnikov.dev/indicator) |
| 拖放:橡皮带边缘,闪烁-觉察到的坐标点 | [拖动](https://fluidkit.mogilnikov.dev/drag) |
| 升起: iOS 上下文菜单 | [电梯](https://fluidkit.mogilnikov.dev/lift) |
| 布局: 元素移动到新位置 | [版式](https://fluidkit.mogilnikov.dev/layout) |
| 运动:泉水和过渡,按名称排列,CSS也使用 | [动议](https://fluidkit.mogilnikov.dev/motion) |
| 地下的泉水、测量和DOM合同 | [核心项目](https://fluidkit.mogilnikov.dev/core) |

没有建台阶? `@fluidkit/core/auto` 导入时安装按:

```html
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@fluidkit/core@2/dist/style.css" />
<script type="module" src="https://cdn.jsdelivr.net/npm/@fluidkit/core@2/dist/auto.js/+esm"></script>
```

## 许可证

麻省理工学院米哈伊尔·莫吉利尼科夫. 见 [自由主义](https://npmcn.com/package/%40fluidkit/core/LICENSE)。 。 。 .

## 常见问题

### @fluidkit/core 是什么？

无框架的流体克特:液态克特的玻璃,形态,指示器,拖曳,起起并布局在能保持其速度的可中断弹簧上,而苹果为CSS的弹簧和过渡\.

### 如何安装 @fluidkit/core？

在项目目录运行 npm install @fluidkit/core，或使用 pnpm add / yarn add / bun add。

### @fluidkit/core 支持 TypeScript 吗？

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

### @fluidkit/core 支持 ESM 还是 CommonJS？

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

### @fluidkit/core 可以商用吗？

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

### @fluidkit/core 的下载量有多少？

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

### @fluidkit/core 还在维护吗？

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