# @cratis/components\.primereact 中文文档

规范地址：https://npmcn.com/package/%40cratis/components.primereact/

版本：4\.40\.0
npm 元数据更新时间：2026-11-04T10:40:02.832Z
中文译文更新时间：2026-11-10T23:24:42.767Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40cratis/components.primereact
原文对照：https://npmcn.com/package/%40cratis/components.primereact/?lang=original
项目主页：https://www.cratis.io/components/
源码仓库：https://github.com/Cratis/Components

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

- 包体积（解压后）：51.8 kB，9 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.0\.0
- 运行依赖：0 个
- peer 依赖：react ^19\.0\.0，react-dom ^19\.0\.0，primereact \>=11 \<12，@primereact/ui \>=11 \<12，@primereact/core \>=11 \<12，@primeuix/themes \>=3 \<4，@cratis/components 4\.40\.0
- 首次发布：2026-08-30T20:54:17.045Z
- 最新版本发布：2026-11-04T10:40:02.506Z
- 近 30 天下载量：7855（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：83（近 12 个月 83 个）

## 中文简介

PrimeReact 11 用于 Cratis 组件渲染器 ABI v1 的演示文稿适配器.

## 安装

```sh
npm install @cratis/components.primereact
```

也可以使用：`pnpm add @cratis/components.primereact`、`yarn add @cratis/components.primereact`、`bun add @cratis/components.primereact`

## README

# `@cratis/components.primereact`

PrimeReact 11 适配器,用于 Cratis 组件渲染器 ABI 中的九个稳定的演示槽 v1. 软件包共享组件寄存器发布版本, 而渲染器 ABI 仍保留 单独版本。 出口一个稳定 `CratisPresentationUiLibrary` 很明显, `primeReactUiLibrary`。这证明九层原始 适应,从不全目录替换. PrimeReact 10 由下列单项支持: `@cratis/components.primereact10`。 。 。 .

> **版本数 :** 每次发布 `@cratis/components.primereact` 出版的版本与 `@cratis/components` 并宣布该版本的对应方。 安装和升级两者 组合在一起,在同一版本.

## 安装

```sh
npm install @cratis/components.primereact@^4 @cratis/components@^4 \
  @primereact/core@^11 @primereact/ui@^11 primereact@^11 \
  @primeuix/themes@^3 react@^19 react-dom@^19
```

基于节点的构建,测试,和服务器的上线环境需要Node.js 22或更新.

适配器使用PrimeReact 11风格组件. 它覆盖了按钮,图标按钮,文本输入, 文本区 复选箱 收音机 开关 进步栏 和 Surface. 五个原子相互作用槽是: 不属于此配置 .

## 申请自有供应商和许可证

PrimeReact 11需要许可证密钥. 该应用程序拥有该键并直接传递到它的 外部 `PrimeReactProvider`; 组件从未接收、存储、复制、日志、序列化或代理 这个 PrimeReact 的运行时上下文故意省略了密钥,所以应用程序也通过一个 非机密布尔证明 `CratisComponentsProvider`。 。 。 .

```tsx
import { PrimeReactProvider } from '@primereact/core/config';
import Aura from '@primeuix/themes/aura';
import { CratisComponentsProvider } from '@cratis/components';
import { primeReactUiLibrary } from '@cratis/components.primereact';

const primeUiLicenseKey = import.meta.env.VITE_PRIMEUI_LICENSE_KEY;

export const Application = () => (
    <PrimeReactProvider license={primeUiLicenseKey} theme={{ preset: Aura }}>
        <CratisComponentsProvider
            value={{ locale: 'en-US' }}
            library={primeReactUiLibrary}
            rendererSetup={{
                'cratis-primereact.license-configured': Boolean(primeUiLicenseKey),
            }}
        >
            <main>Application content</main>
        </CratisComponentsProvider>
    </PrimeReactProvider>
);
```

执行命令或运行查询的组件也需要Arc's `<Arc>` 提供者从 `@cratis/arc.react` 环绕这棵树;适配器和 `CratisComponentsProvider` 替换它.

适配器抛出 `CRATIS-UI-1005` 当外部提供者或证明时同步 缺席。 提供证明 `true` 是一个应用程序断言, 密钥其实是 它不能代替这样做。 这使得组件无法创建第二个 提供者, 设置时在适配器内容前失败 。 适配器不验证 并且不能保证PrimeUI会接受它或者省略自己的执照通知. 对于没有钥匙的发展, [明确选择内置核心渲染器](https://github.com/Cratis/Components/blob/main/Documentation/renderers/licensing.md#develop-without-a-primereact-key) 而不是选择此适配器; 缺失的证明永远不会触发许可证倒置 .

从 [总理](https://primeui.store/primeui)对于Vite, 披露应用程序拥有者 键为 `VITE_PRIMEUI_LICENSE_KEY` 只在客户端构建中安装 PrimeReact 。 在CI或a中 发布管道, 绘制保护地图 `PRIMEUI_LICENSE_KEY` 隐藏到该构建变量中 呼应或写入包装文物. 适配软件包本身没有读取许可证 环境变量,不包括密钥.

## 造型和安保部

应用程序在其外部提供者上选择PrimeReact主题. 软件包的静态元数据 用途 `VITE_PRIMEUI_LICENSE_KEY` 仅作为文档/发现元数据;没有进行运行时间查找. 所有9个槽都产生确定性的安全部门改革产出,具有代表性的按钮固定水合物 没有不匹配。 主机仍然负责PrimeReact的提供者,主题,CSP,和风格 收集/注入要求.

## 同伴政策

PrimeReact 软件包被绑定到 `>=11 <12`, PrimeUX 主题改为 `>=3 <4`,然后反应/反应DOM 反应19。 供应商包是同行的,从不捆绑. 包装的消费矩阵证明 PrimeReact 11.0.0 和 11.2.0 随同使用 `@primeuix/themes` 3.0.0;适配器自身的构造和测试用途 11.1.0 (中文(简体) ).

来源清单声明 `@cratis/components >=4 <5`,主要组件,其生成ABI 并稳定适配器执行的演示文稿。 发布步骤替换为 因此,公布的适配器要求 `@cratis/components` 放开它 运出.

见 [文 件 交 织](https://npmcn.com/package/%40cratis/components.primereact/CONFORMANCE.md) 证据和证据 [第三次议会 NoTICES.md](https://npmcn.com/package/%40cratis/components.primereact/THIRD_PARTY_NOTICES.md) 对上游许可.

## 常见问题

### @cratis/components\.primereact 是什么？

PrimeReact 11 用于 Cratis 组件渲染器 ABI v1 的演示文稿适配器\.

### 如何安装 @cratis/components\.primereact？

在项目目录运行 npm install @cratis/components\.primereact，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^19\.0\.0）、react-dom（^19\.0\.0）、primereact（\>=11 \<12）、@primereact/ui（\>=11 \<12）、@primereact/core（\>=11 \<12）、@primeuix/themes（\>=3 \<4）、@cratis/components（4\.40\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @cratis/components\.primereact 支持 TypeScript 吗？

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

### @cratis/components\.primereact 支持 ESM 还是 CommonJS？

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

### @cratis/components\.primereact 需要什么版本的 Node\.js？

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

### @cratis/components\.primereact 可以商用吗？

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

### @cratis/components\.primereact 的下载量有多少？

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

### @cratis/components\.primereact 还在维护吗？

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