SuperAPI AI 工具集

javascript-author

通用与其它

查看项目

更新于 10-16 03:48

技能介绍

用途:该技能用于创建 JavaScript 文件、构建交互式组件时,编写符合“函数式内核+命令式外壳”架构的现代原生 JavaScript Web Components。

主要能力:函数式内核指纯函数、getter、计算值,无副作用;命令式外壳指 DOM 操作、事件处理、副作用放在生命周期钩子中。支持依赖注入,从独立文件导入模板、样式、i18n;仅使用具名导出,禁止默认导出;要求用 JSDoc 记录类、公共方法和事件。

文件结构:每个组件一个目录,包含主组件类文件、模板函数文件(-template.js)、CSS-in-JS 样式文件(-styles.js)和翻译对象文件(-i18n.js)。

用法要点:组件类继承 HTMLElement,定义 observedAttributes,在构造函数中 attachShadow({ mode: 'open' }),getter 放纯逻辑,render() 负责写入 shadowRoot.innerHTML,在 connectedCallback 渲染并挂监听,在 disconnectedCallback 清理观察器和监听器(必需),attributeChangedCallback 在属性变化时重渲染,最后 customElements.define 注册并具名导出。

命名约定:变量与函数用 camelCase,类用 PascalCase,自定义元素和事件用 kebab-case,CSS 类用 kebab-case。ESLint 规则强制 no-var、prefer-const、prefer-template、eqeqeq、camelcase、object-shorthand,并要求具名导出。

适用场景:构建带 Shadow DOM 与国际化支持的 Web Components;需要清晰分离纯逻辑与副作用的前端代码。

限制:资料未提供安装命令、版本、收费、浏览器兼容范围或运行环境要求;使用前需按项目实际情况自行确认工具链与 ESLint 配置。