# @gluhar/fluid 中文文档

规范地址：https://npmcn.com/package/%40gluhar/fluid/

版本：6\.4\.1
npm 元数据更新时间：2026-11-16T12:44:24.155Z
中文译文更新时间：2026-11-16T16:57:40.412Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40gluhar/fluid
原文对照：https://npmcn.com/package/%40gluhar/fluid/?lang=original
项目主页：https://github.com/gluharco/gluhar#readme
源码仓库：https://github.com/gluharco/gluhar

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

- 包体积（解压后）：17.5 kB，3 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：0 个
- peer 依赖：tailwindcss ^4\.0\.0
- 首次发布：2026-10-20T18:06:57.067Z
- 最新版本发布：2026-11-16T12:44:23.880Z
- 近 30 天下载量：2833（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：22（近 12 个月 22 个）

## 中文简介

Tailwind CSS v4 插件,用于流体,设备带宽打字和通过夹接间隔().

## 安装

```sh
npm install @gluhar/fluid
```

也可以使用：`pnpm add @gluhar/fluid`、`yarn add @gluhar/fluid`、`bun add @gluhar/fluid`

## README

# `@gluhar/fluid`

尾风 CSS v4 插件:流体类型和间距通过 `clamp()`,与 **设备带宽** 打字法——每个设备波段一个坡道,堆放为分毫宽的查询,连续跨越波段边界.

框架-不可知:是Tailwind插件,不是Nuxt模块. `@gluhar/theme` 不依赖它.

## 使用

```css
@import "tailwindcss";
@plugin "@gluhar/fluid" {
  bands: mobile, tablet, desktop;
}

@theme {
  /* min / design / max viewport, px. The LAST band listed is primary. */
  --fl-band-mobile: 320 390 480;
  --fl-band-tablet: 768 820 1200;
  --fl-band-desktop: 1200 1600 1920;

  /* Display: proportional. Plain token = primary band's design value. */
  --text-5xl: 3.75rem;
  --text-5xl--tablet: 2.4375rem 2.625rem 2.8125rem; /* lower base upper */
  --text-5xl--mobile: 1.75rem 2.125rem 2.4375rem;

  /* Body/UI: two values = linear between the band's own endpoints. */
  --text-md: 1rem;
  --text-md--desktop: 0.9375rem 1.05rem;
  --text-md--tablet: 0.9rem 0.9375rem;
  --text-md--mobile: 0.85rem 0.9rem;
}
```

礛 `fl-text-5xl`, (中文(简体) ), `fl-text-md`, (中文(简体) ), `fl-p-4`, (中文(简体) ), `fl-gap-8`, (中文(简体) ), `fl-text-[32px]`, (中文(简体) ), `fl-text-sm/xl`, (中文(简体) ), `fl-py-4/8`。 。 。 .

## 规则

-   **一旦项目使用带宽类型,使用 `fl-text-*` 到处都是.** 平面 `text-*` 获得没有斜坡的单一主值.
-   **永远不要把多值形式放在平地上 `--text-*` 符号 .** 尾风自己的 `text-*` 发射 `font-size: var(--text-*)` 逐字逐句,故原生用法寂灭. 插件警告 。 限制 `--text-<key>--<band>`。 。 。 .
-   使每个波段的上端点等同下个波段的下端点,因此分级在断点上没有步骤.
-   给正文/UI复制件的双值表(gentle spound); 显示大小的正文 / 三值表.

## 限制(已知,目前按设计)

-   间距公用设施没有被带宽——它们使用主带的窗口.
-   行高读取一次(`lineHeight: true` 选项),而不是每个带.
-   任意价值`fl-text-[32px]`决心只对主乐团.

## 常见问题

### @gluhar/fluid 是什么？

Tailwind CSS v4 插件,用于流体,设备带宽打字和通过夹接间隔\(\)\.

### 如何安装 @gluhar/fluid？

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

### @gluhar/fluid 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/gluhar\_\_fluid 是否存在。

### @gluhar/fluid 支持 ESM 还是 CommonJS？

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

### @gluhar/fluid 可以商用吗？

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

### @gluhar/fluid 的下载量有多少？

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

### @gluhar/fluid 还在维护吗？

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

