@cntrl-site/components

中文文档
1.0.114发布于 2026/11/10MITTypeScriptESM + CJS近 30 天下载 6835

自定义用于控制编辑器和公共网站的组件.

中文使用文档

控制组件

这是用于控制编辑器和公共网站的自定义组件.

懒惰元素

@cntrl-site/components/elements 给出内置组件执行,而不将其全部装入前端:

  • hasComponentElement(id): 是否为 id 是一个内置组件.
  • getComponentElement(id): 元素,如果它已经装入.
  • loadComponentElement(id):装入. 并联通话共享一个请求.
  • hasComponentElementFailed(id): 负载失败后为真, 直到重试成功 .

在浏览器中,每个组件都是自己的块. 在装入失败后,在接下来的2 s (当时为4 s) 内的呼叫返回相同的拒绝,而不是再次取回,一个组件每页装入最多得到三次尝试.

在 node 导出条件 elements.node,它具有每一个元素同步,所以服务器渲染包括所有组件.

欢乐

jsdom 测试环境解析 browser 财务报告和审定财务报表 require 条件,而不是 nodeJest不能运行浏览器的原生变体 import() 无 --experimental-vm-modules。将子路径映射到节点变体 jest.config.js数字 :

moduleNameMapper: {
  '^@cntrl-site/components/elements$': require.resolve('@cntrl-site/components/elements'),
},

require.resolve 在配置加载时在节点运行,所以返回 dist/elements.node.js。 。 。 .

版本与发布记录

@cntrl-site/components 共发布 504 个版本,首次发布于 2025/10/17;过去 12 个月发布了 494 个版本。

版本发布日期距今
1.0.114latest2026/11/10今天
1.0.1132026/11/054 天前
1.0.1122026/11/054 天前
1.0.1112026/11/054 天前
1.0.111-alpha.1alpha2026/11/045 天前
1.0.111-alpha.02026/11/045 天前

其他发布通道:grid → 0.1.30-grid.1,alpha → 1.0.111-alpha.1。

关于 @cntrl-site/components 的常见问题

@cntrl-site/components 是什么?

自定义用于控制编辑器和公共网站的组件.

如何安装 @cntrl-site/components?

在项目目录运行 npm install @cntrl-site/components,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^18.0.0)、react-dom(^18.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@cntrl-site/components 支持 TypeScript 吗?

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

@cntrl-site/components 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@cntrl-site/components 可以商用吗?

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

@cntrl-site/components 的下载量有多少?

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

@cntrl-site/components 还在维护吗?

最新版本 1.0.114 发布于 2026/11/10(今天);至今共发布 504 个版本,其中过去 12 个月发布了 494 个;首次发布于 2025/10/17。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。