用途:在项目已确认使用 LWC 框架后,指导 KWC LWC 组件的开发、修改与维护,并约束代码规范与组件用法。使用前置条件:当前目录存在 .kd/config.json 且 framework 值为 lwc,工程已通过 kwc-project-scaffold 完成初始化;不满足时须停止并切换到 kwc-project-scaffold。本技能不处理工程初始化、创建组件或页面、生成或修改 .js-meta.kwc 与 .page-meta.kwp、环境配置、部署与调试,这些均交由 kwc-project-scaffold。主要能力:指导按平台差异编写代码。@kdcloudjs/kwc 是 Salesforce LWC 的 100% 语法克隆,差异包括基类用 KingdeeElement(导入自 @kdcloudjs/kwc)、配置文件为 kwc.config.json、组件库使用 <sl-button kwc:external> 等而非 lightning-。约束摘要:HTML 中禁止 JS 表达式、禁止自闭合标签、禁止 ID 选择器;HTML 仅绑定原生事件,Shoelace 自定义事件(如 sl-change)须在 renderedCallback 中绑定;sl- 标签必须加 kwc:external,属性全小写;JS 继承 KingdeeElement,DOM 查询用 .class;CSS 须使用 Shoelace Design Token(var(--sl-color-)、var(--sl-spacing-)、var(--sl-font-size-)、var(--sl-border-radius-)),禁止硬编码 hex 色值与 px 数值。使用方式:新建组件必须用 CLI,命令为 kd project create [组件名] --type kwc,组件名遵循 camelCase;实现前须先参考 app/kwc/exampleComponent 或技能目录下 ./assets/examples 示例,并遵守 rule.md;完成后更新 app/kwc/main* 引用,运行 npm run dev 验证。资源包括 @kdcloudjs/shoelace(@shoelace-style/shoelace 的克隆,标准组件 API 一致,另新增 KWC 业务组件),标准组件文档见 https://shoelace.style/,扩展组件文档位于本技能 reference/ 目录(如 Table、DatePicker、Upload、Sender 等),业务组件 Lookup (F7) 导入路径为 @kdcloudjs/shoelace-biz/dist/components/...,使用前须阅读相应文档。限制:不运行 ESLint/Prettier 修复命令并忽略其格式报错;未提供收费、平台支持范围等更多信息。
kwc-lwc-development
编程与开发
更新于 10-15 20:10