# @crestron/ch5-crcomlib 中文文档

规范地址：https://npmcn.com/package/%40crestron/ch5-crcomlib/

版本：2\.20\.0
npm 元数据更新时间：2026-10-14T14:27:05.965Z
中文译文更新时间：2026-11-11T00:25:24.291Z
软件包许可：SEE LICENSE IN LICENSE\.txt

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

原始 npm 页面：https://www.npmjs.com/package/%40crestron/ch5-crcomlib
原文对照：https://npmcn.com/package/%40crestron/ch5-crcomlib/?lang=original
项目主页：https://github.com/Crestron/CH5ComponentLibrary#readme
源码仓库：https://github.com/Crestron/CH5ComponentLibrary

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

- 包体积（解压后）：29.7 MB，1331 个文件
- TypeScript 类型：包内自带
- Node.js 要求：\>=24\.18\.0
- 运行依赖：9 个
- 首次发布：2019-06-20T22:21:23.025Z
- 最新版本发布：2026-10-14T14:27:05.770Z
- 近 30 天下载量：12736（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：466（近 12 个月 9 个）

## 中文简介

Crestron HTML5 (CH5) 组件库

## 安装

```sh
npm install @crestron/ch5-crcomlib
```

也可以使用：`pnpm add @crestron/ch5-crcomlib`、`yarn add @crestron/ch5-crcomlib`、`bun add @crestron/ch5-crcomlib`

## README

![](https://kenticoprod.azureedge.net/kenticoblob/crestron/media/crestron/generalsiteimages/crestron-logo.png)

# CH5 - Crestron 组件库( CrComLib) - 开始

## 文档参见 Crestron 开发者网站

[https://www.crestron.com/developer (中文(简体) )](https://www.crestron.com/developer) 搜索 CRESTRON HTML5 用户界面

## 生成的文件夹

-   构建( b)_模块 类型_ - 包含由webpack生成的文件(以及 esm 模块的打字程序编译器)
-   已编译 bundles/_模块 类型_ - 包含由打字机编译器生成的文件(tsc)
-   文档/html

何处 _模块 类型_ 为:

-   _是吗_ - UMD(包含CommonJs,AMD,并在窗口对象中创建全球属性).
-   _(单位:千美元)_ - 常见J
-   _风向_ - ES模块,ES6.
-   _页:1_ - 同步模块定义

## 在浏览器控制台上激活额外信息

### Ch5 组件

Ch5组件如果定义了调试属性,将在浏览器控制台上显示额外信息. 例如: `<ch5-button debug label="Btn1"></ch5-button>`

### 对于ch5自定义属性(data-ch5-.)

如果元素具有调试属性,将在浏览器控制台上显示更多信息. 例如: `<div debug data-ch5-show="a_signal">Hello</div>`

### 与桥梁有关的功能/方法

要显示额外信息, 您必须首先使用来自 Ch5Debug 的方法启用 :

-   getConfig - 返回当前配置:所有可以设置的密钥及其当前值。 密钥启用调试信息 方法/职能
-   装入 Config( cfg) - 装入新配置( 替换上一个配置)
-   启用 All() - 启用所有密钥。 将显示所有可用的调试信息 。 (使用 Ch5 调试的调试信息, 调试信息) 从 ch5 组件开始,自定义属性不会受到影响)
-   禁用全部 () - 禁用所有密钥
-   设置 ConfigKeyValue( 键: 字符串, 值: boolean) - 更改密钥的值

### 构建 Dev 通用模块定义

npm 运行构建: dev:umd

### 开始

npm 运行开始

### 本地主机 3000 有参数 IP ID 和 主机

http://localhost:30:00/?ipId=0x99&host=10.0.0.203 (英语)

## 怎么样

对 Crestron HTML5 用户界面的更新和文档可在以下链接中验证 [https://sdkcon78221.crestron.com/sdk/Crestron HTML5UI/Content/Topics/Whats-New.htm 页面存档备份,存于互联网档案馆](https://sdkcon78221.crestron.com/sdk/Crestron_HTML5UI/Content/Topics/Whats-New.htm)

### npm 链接

cd 峰值组件-lib npm 链接

cd CH5Sandbox\\ shell-template (简体中文)  
npm 链接@ crestron/ch5-crcomlib

## 常见问题

### @crestron/ch5-crcomlib 是什么？

Crestron HTML5 \(CH5\) 组件库

### 如何安装 @crestron/ch5-crcomlib？

在项目目录运行 npm install @crestron/ch5-crcomlib，或使用 pnpm add / yarn add / bun add。

### @crestron/ch5-crcomlib 支持 TypeScript 吗？

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

### @crestron/ch5-crcomlib 需要什么版本的 Node\.js？

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

### @crestron/ch5-crcomlib 可以商用吗？

@crestron/ch5-crcomlib 使用 SEE LICENSE IN LICENSE\.txt 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @crestron/ch5-crcomlib 的下载量有多少？

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

### @crestron/ch5-crcomlib 还在维护吗？

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