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

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

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

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

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

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

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

## 中文简介

PrimeReact 10 用于 Cratis 组件渲染器 ABI v1.

## 安装

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

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

## README

# `@cratis/components.primereact10`

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

PrimeReact 11使用不同的软件包架构和许可边界. 单独支持 以 `@cratis/components.primereact`;两个适配器必须使用孤立的上游依赖图.

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

## 安装

```sh
npm install @cratis/components.primereact10@^4 @cratis/components@^4 \
  primereact@^10.9.9 react@^19 react-dom@^19
```

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

适配器涵盖按钮,图标按钮,文本输入,文本区,复选箱,无线电,开关,进步列, 还有水面 五个原子相互作用插槽不是这个剖面图的一部分,而是通过 组件内置倒置.

PrimeReact 10是麻省理工学院的许可,不需要PrimeUI密钥或组件渲染器设置证明. 10.9.9版本是上游得到支持的最低版本,因为它确定了原型污染咨询 影响PrimeReact发布至10.9.8.

## 主题和全球配置

PrimeReact 10 有样式的组件需要一个应用程序选择的主题样式表. 导入一次 应用程序前的应用程序切入点 :

```ts
import 'primereact/resources/themes/lara-light-cyan/theme.css';
```

分布主题为预编译 CSS,不需要Sass. 只有在一个 应用程序选择编译自定义 PrimeReact 10 主题。 PrimeIcons 可选; 安装和 导入 `primeicons/primeicons.css` 只有应用程序直接使用PrimeIcons.

外边 `PrimeReactProvider` 是可选的。 适配器仅在 应用程序没有提供。 应用程序可以拥有全局 PrimeReact 10 选项,例如 连接 , 语言、 CSP 非ce、 样式容器、 通道默认, 或 Z 索引配置 :

```tsx
import { PrimeReactProvider } from 'primereact/api';
import { CratisComponentsProvider } from '@cratis/components';
import { primeReact10UiLibrary } from '@cratis/components.primereact10';

export const Application = () => (
    <PrimeReactProvider value={{ ripple: true }}>
        <CratisComponentsProvider
            value={{ locale: 'en-US' }}
            library={primeReact10UiLibrary}
        >
            <main>Application content</main>
        </CratisComponentsProvider>
    </PrimeReactProvider>
);
```

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

应用程序拥有主题导入和任何外部提供者配置. 组件没有 配置应用程序的直接 PrimeReact 使用 .

## 安全部门改革和软件包边界

所有9个插槽都需制作定型静态标记,代表按钮 fixture 必须在不匹配的情况下进行水合。 PrimeReact 10 早于现代软件包导出地图,所以 适配器被打包的跑时门验证了所出版的建筑所使用的准确的遗留模块互通. 主机仍然负责将全球主题CSS装入框架指定的位置,并负责 CSP或风格-容器配置.

PrimeReact 是一个被绑定的对等方,从未捆绑过. 精确的仓库证明使用 PrimeReact 10.9.9和19反应。 PrimeReact 10 和 11 无法满足彼此的对等范围, 也不得共享 一个故事本预览或应用程序依赖性解析.

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

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

## 常见问题

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

PrimeReact 10 用于 Cratis 组件渲染器 ABI v1\.

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

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

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

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

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

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

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

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

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

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

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

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

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

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