@genexus/chameleon-controls-library

中文文档
6.38.0发布于 2026/10/14MITTypeScriptES Module近 30 天下载 2156

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

中文使用文档
文档目录12 节
  1. 使用此库
  2. 在框架(React,Angular等)中使用了水星或Unanimo等设计系统.
  3. 在Stencil项目中
  4. 节点模块
  5. 脚本标签
  6. 无障碍检查器
  7. 每个控制中发展状况的含义
  8. 地方发展
  9. 运行测试
  10. 生产大楼
  11. 商标
  12. 许可证
基因解析器@ main
CI

Netlify Status Built With Stencil code style: prettier

变色龙

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

访问 变色龙显示框 用于一般信息、演示和文件.

使用此库

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

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

为此,我们建议咨询我们的存储器 变色龙融合 包含各种实例,说明如何在不同框架和不同设计系统中有效利用变色龙控制库.

反应

  • 运行

    npm i @genexus/chameleon-controls-library --save
    
  • 从变色龙版本开始 6.4.0,有一个CLI来创建 React Web 组件包装. 要创建包装, 请运行以下命令 :

    npx chameleon-generate-react <output dir (optional)>
    

    例如:

    npx chameleon-generate-react ./src/chameleon-components
    
  • 提示: 我们建议在您的 package.json 在运行 dev 服务器和生产构建之前的文件,因为执行所需的时间不到300ms.

    例如:

    "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项目中

  • 运行

    npm i @genexus/chameleon-controls-library --save
    
  • 向内部库添加导入 src/index.ts数字 :

    import "@genexus/chameleon-controls-library";
    
  • 然后可以在模板,JSX,html等的任何地方使用网络组件.

节点模块

  • 运行

    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

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

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

disableAccessibilityReports();

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

类别说明
"experimental"控制处于开发初期. 这个阶段对于早期的测试控制经常有用,但界面很可能会从最终版本中改变.

断开控件的更改可以在"patch"标记中被应用.
"developer-preview"控制处于开发的最后阶段. 执行控件的界面和行为几乎已经完成. 控件的界面不应与最终版本变化太大.

断开控件的更改可以在"patch"标记中被应用.
"stable"控制器的开发是稳定的,可以安全地用于生产环境.

断开控件的更改可以在"Major"标记中被应用. 在某些情况下,会使用两个"Major"标记来去腐烂控制中的行为.

地方发展

npm i
npm start

运行测试

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

npm test

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

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) 的更改, 运行 :

npm run test.watch

只看一个文件, 运行 :

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

只看一个文件夹, 运行 :

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

## For example:

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

生产大楼

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

npm run build

商标

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

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

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

许可证

这个项目根据Apache许可证2.0版本获得许可. 见 自由主义 完整文本的文档.

版权:2024 GeneXus S.

版本与发布记录

@genexus/chameleon-controls-library 共发布 223 个版本,首次发布于 2023/05/16;过去 12 个月发布了 13 个版本。

版本发布日期距今
6.38.0latest2026/10/141 个月前
6.37.02026/08/123 个月前
6.36.12026/07/283 个月前
6.34.02026/03/287 个月前
6.33.12026/03/098 个月前
6.33.02026/03/078 个月前

关于 @genexus/chameleon-controls-library 的常见问题

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