# @genexus/chameleon-controls-library 中文文档

规范地址：https://npmcn.com/package/%40genexus/chameleon-controls-library/

版本：6\.38\.0
npm 元数据更新时间：2026-10-14T14:36:20.532Z
中文译文更新时间：2026-11-16T03:35:18.568Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40genexus/chameleon-controls-library
原文对照：https://npmcn.com/package/%40genexus/chameleon-controls-library/?lang=original

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

- 包体积（解压后）：79.2 MB，3178 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：9 个
- peer 依赖：lit ^3\.3\.2，katex \>=0\.18\.2 \<0\.20\.0，@genexus/kasstor-webkit ^0\.3\.0
- 首次发布：2023-05-15T19:58:54.664Z
- 最新版本发布：2026-10-14T14:36:20.008Z
- 近 30 天下载量：2156（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：223（近 12 个月 13 个）

## 中文简介

变色龙 -- -- 白标签、高度定制和可重复使用的网络组件库

## 安装

```sh
npm install @genexus/chameleon-controls-library
```

也可以使用：`pnpm add @genexus/chameleon-controls-library`、`yarn add @genexus/chameleon-controls-library`、`bun add @genexus/chameleon-controls-library`

## README

| 基因解析器@ main |
| --- |
| [![CI](https://github.com/genexuslabs/chameleon-controls-library/actions/workflows/node.js.yml/badge.svg)](https://github.com/genexuslabs/chameleon-controls-library/actions/workflows/node.js.yml) |

[![Netlify Status](https://api.netlify.com/api/v1/badges/ce65d606-d581-41c5-bba7-fb330c333739/deploy-status)](https://app.netlify.com/sites/gx-chameleon/deploys) ![Built With Stencil](https://img.shields.io/badge/-Built%20With%20Stencil-16161d.svg?logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz4KPCEtLSBHZW5lcmF0b3I6IEFkb2JlIElsbHVzdHJhdG9yIDE5LjIuMSwgU1ZHIEV4cG9ydCBQbHVnLUluIC4gU1ZHIFZlcnNpb246IDYuMDAgQnVpbGQgMCkgIC0tPgo8c3ZnIHZlcnNpb249IjEuMSIgaWQ9IkxheWVyXzEiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgeG1sbnM6eGxpbms9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkveGxpbmsiIHg9IjBweCIgeT0iMHB4IgoJIHZpZXdCb3g9IjAgMCA1MTIgNTEyIiBzdHlsZT0iZW5hYmxlLWJhY2tncm91bmQ6bmV3IDAgMCA1MTIgNTEyOyIgeG1sOnNwYWNlPSJwcmVzZXJ2ZSI%2BCjxzdHlsZSB0eXBlPSJ0ZXh0L2NzcyI%2BCgkuc3Qwe2ZpbGw6I0ZGRkZGRjt9Cjwvc3R5bGU%2BCjxwYXRoIGNsYXNzPSJzdDAiIGQ9Ik00MjQuNywzNzMuOWMwLDM3LjYtNTUuMSw2OC42LTkyLjcsNjguNkgxODAuNGMtMzcuOSwwLTkyLjctMzAuNy05Mi43LTY4LjZ2LTMuNmgzMzYuOVYzNzMuOXoiLz4KPHBhdGggY2xhc3M9InN0MCIgZD0iTTQyNC43LDI5Mi4xSDE4MC40Yy0zNy42LDAtOTIuNy0zMS05Mi43LTY4LjZ2LTMuNkgzMzJjMzcuNiwwLDkyLjcsMzEsOTIuNyw2OC42VjI5Mi4xeiIvPgo8cGF0aCBjbGFzcz0ic3QwIiBkPSJNNDI0LjcsMTQxLjdIODcuN3YtMy42YzAtMzcuNiw1NC44LTY4LjYsOTIuNy02OC42SDMzMmMzNy45LDAsOTIuNywzMC43LDkyLjcsNjguNlYxNDEuN3oiLz4KPC9zdmc%2BCg%3D%3D&colorA=16161d&style=flat-square) [![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square)](https://github.com/prettier/prettier)

# 变色龙

一个包含白标签,高度定制和可再使用的网页组件的库.

访问 [变色龙显示框](https://gx-chameleon.netlify.app/) 用于一般信息、演示和文件.

## 使用此库

我们建议使用这些网络组件有四种战略.

### 在框架(React,Angular等)中使用了水星或Unanimo等设计系统.

为此,我们建议咨询我们的存储器 [变色龙融合](https://github.com/genexuslabs/chameleon-integrations) 包含各种实例,说明如何在不同框架和不同设计系统中有效利用变色龙控制库.

#### 反应

-   运行
    
    ```bash
    npm i @genexus/chameleon-controls-library --save
    ```
    
-   从变色龙版本开始 `6.4.0`,有一个CLI来创建 React Web 组件包装. 要创建包装, 请运行以下命令 :
    
    ```bash
    npx chameleon-generate-react <output dir (optional)>
    ```
    
    例如:
    
    ```bash
    npx chameleon-generate-react ./src/chameleon-components
    ```
    
-   **提示**: 我们建议在您的 `package.json` 在运行 dev 服务器和生产构建之前的文件,因为执行所需的时间不到300ms.
    
    例如:
    
    ```json
    "dev": "npm run build.chameleon && ...",
    "build": "npm run build.chameleon && ..."
    "build.chameleon": "chameleon-generate-react <output dir (optional)>"
    ```
    
    如果您处于单曲环境, 您可能需要使用 `npx chameleon-generate-react`, (中文(简体) ), `yarn chameleon-generate-react`等 (中文(简体) ).
    
-   最后,你要做的就是使用项目中的组件!
    

### 在Stencil项目中

-   运行
    
    ```bash
    npm i @genexus/chameleon-controls-library --save
    ```
    
-   向内部库添加导入 `src/index.ts`数字 :
    
    ```ts
    import "@genexus/chameleon-controls-library";
    ```
    
-   然后可以在模板,JSX,html等的任何地方使用网络组件.
    

### 节点模块

-   运行
    
    ```bash
    npm i @genexus/chameleon-controls-library --save
    ```
    
-   设置类似此的脚本标签 `<script src="node_modules/@genexus/chameleon-controls-library/dist/chameleon/chameleon.esm.js"></script>` 在索引.html的首页
    
-   然后可以在模板的任何地方使用网络组件, JSX, html等
    

### 脚本标签

-   设置类似此的脚本标签 `<script src="https://unpkg.com/@genexus/chameleon-controls-library@latest/dist/chameleon/chameleon.esm.js"></script>` 在索引.html的首页
    
-   然后可以在模板的任何地方使用网络组件, JSX, html等
    

## 无障碍检查器

从变色龙版本开始 `6.4.0` 新的无障碍工具用于检查形式元素是否有有效的标签并通知(`console.warn`当他们没有完成这个条件。 此时,它被支持在以下组件中:

-   `ch-combo-box-render`
-   `ch-edit`
-   `ch-progress`
-   `ch-slider`

无障碍检查器默认启用,可禁用如下:

```ts
import { disableAccessibilityReports } from "@genexus/chameleon-controls-library/dist/collection";

disableAccessibilityReports();
```

## 每个控制中发展状况的含义

| 类别 | 说明 |
| --- | --- |
| `"experimental"` | 控制处于开发初期. 这个阶段对于早期的测试控制经常有用,但界面很可能会从最终版本中改变.  
  
断开控件的更改可以在"patch"标记中被应用. |
| `"developer-preview"` | 控制处于开发的最后阶段. 执行控件的界面和行为几乎已经完成. 控件的界面不应与最终版本变化太大.  
  
断开控件的更改可以在"patch"标记中被应用. |
| `"stable"` | 控制器的开发是稳定的,可以安全地用于生产环境.  
  
断开控件的更改可以在"Major"标记中被应用. 在某些情况下,会使用两个"Major"标记来去腐烂控制中的行为. |

## 地方发展

```bash
npm i
npm start
```

### 运行测试

要运行自定义元素的单元测试, 运行:

```bash
npm test
```

要运行特定自定义元素的光谱测试, 请运行 :

```bash
npm run test.spec src/components/<path to test file.spec.ts>

## For example:

npm run test.spec src/components/layout-splitter/tests/fixAndUpdateLayoutModel.spec.ts
```

要监视测试( spec and e2e) 的更改, 运行 :

```bash
npm run test.watch
```

只看一个文件, 运行 :

```bash
npm run test.watch -- -- src/components/edit/<path to test file.<spec|e2e>.ts>

## For example:

npm run test.watch -- -- src/components/edit/tests/edit.e2e.ts
```

只看一个文件夹, 运行 :

```bash
npm run test.watch -- -- <folder path>

## For example:

npm run test.watch -- -- src/components/edit/tests/
```

### 生产大楼

为了构建生产设计,运行:

```bash
npm run build
```

## 商标

本项目可参考第三方的名称,标志和品牌. 所有此类提法仅用于识别目的,并不意味着GeneXus S.A.与相关商标所有人之间的任何背书、担保或隶属关系.

-   **基因Xus** 是GeneXus S.A的商标或注册商标.
-   **变色龙**, (中文(简体) ), **汞**,以及 **团结** 是GeneXus S.A的产品名称.
-   **反应** 是Meta平台公司的一个商标.
-   **角质** 是Google LLC的商标.
-   **斯坦西尔** 是"漂流公司"(Ionic)的商标.
-   **摩纳哥编辑器** 是微软公司的产品.
-   **无** 是npm公司的一个商标.

该项目中提到的所有其他商标、服务标志和产品名称均为其各自所有人的财产.

## 许可证

这个项目根据Apache许可证2.0版本获得许可. 见 [自由主义](https://npmcn.com/package/%40genexus/chameleon-controls-library/LICENSE) 完整文本的文档.

版权:2024 GeneXus S.

## 常见问题

### @genexus/chameleon-controls-library 是什么？

变色龙 -- -- 白标签、高度定制和可重复使用的网络组件库

### 如何安装 @genexus/chameleon-controls-library？

在项目目录运行 npm install @genexus/chameleon-controls-library，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：lit（^3\.3\.2）、katex（\>=0\.18\.2 \<0\.20\.0）、@genexus/kasstor-webkit（^0\.3\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 chameleon-generate-react，可以用 npx chameleon-generate-react 直接运行。

### @genexus/chameleon-controls-library 支持 TypeScript 吗？

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

### @genexus/chameleon-controls-library 支持 ESM 还是 CommonJS？

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

### @genexus/chameleon-controls-library 可以商用吗？

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

### @genexus/chameleon-controls-library 的下载量有多少？

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

### @genexus/chameleon-controls-library 还在维护吗？

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

