@cratis/components.primereact

中文文档
4.40.0发布于 2026/11/04MITTypeScriptES Module零依赖构建来源已验证近 30 天下载 7855

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

中文使用文档
文档目录4 节
  1. 安装
  2. 申请自有供应商和许可证
  3. 造型和安保部
  4. 同伴政策

@cratis/components.primereact

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

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

安装

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。 。 。 .

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会接受它或者省略自己的执照通知. 对于没有钥匙的发展, 明确选择内置核心渲染器 而不是选择此适配器; 缺失的证明永远不会触发许可证倒置 .

从 总理对于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 放开它 运出.

见 文 件 交 织 证据和证据 第三次议会 NoTICES.md 对上游许可.

版本与发布记录

@cratis/components.primereact 共发布 83 个版本,首次发布于 2026/08/31;过去 12 个月发布了 83 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
4.40.0latest2026/11/046 天前
4.39.52026/11/046 天前
4.39.42026/11/047 天前
4.39.32026/11/037 天前
4.39.22026/11/037 天前
4.39.12026/11/037 天前

其他发布通道:bootstrap → 0.0.0。

关于 @cratis/components.primereact 的常见问题

@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 和提交记录判断。