用途:该技能聚焦 Stimulus 控制器的基础写法,目标是实现生命周期与状态边界清晰的控制器。核心工作流是先定义控制器契约,即 targets、values、outlets、actions 与预期生命周期;需要在响应式更新时把状态转换放在 value 回调中;对可能在 connect() 完成前运行的 callback 做保护;用 connect()/disconnect() 保持初始化与清理对称;把 DOM 事件处理与业务规则隔离,保持控制器可组合。
主要能力与约束:优先使用声明式 action 参数而非手动解析 dataset;控制器之间通信使用 outlets,而不是访问私有内部;target 回调保持幂等并考虑重复 connect/disconnect;仅在需要 DOM 驱动响应式时使用 MutationObserver;在暴露 UI 能力前先做浏览器 API 特性检测。
使用方式:按需选择性阅读参考文件,例如 value changed 回调、键盘 action 过滤与热键、基于 MutationObserver 的排序、Outlets API 通信、target 回调编排、Web Share API 集成、Core Web Vitals 与懒加载,以及返回 Promise 的 outlet 方法。完整目录见 references/INDEX.md。相关邻近技能:表单行为用 hwc-forms-validation,Turbo 导航/历史/缓存用 hwc-navigation-content,Turbo Stream 与 WebSocket 编排用 hwc-realtime-streaming,媒体集成与播放用 hwc-media-content,UX 反馈/过渡/进度用 hwc-ux-feedback。
限制:本次资料未提供安装命令、价格、平台或效果数据。