用途:该技能用于实现健壮的 Stimulus 控制器,明确生命周期与状态边界,适合 Rails/Hotwire 前端交互开发。
主要能力:覆盖 Stimulus 控制器基础,包括生命周期钩子、values 与 valueChanged 回调、targets 与 target 回调、outlets、action 参数、键盘事件过滤与快捷键、MutationObserver 排序、Web Share API 集成,以及 Core Web Vitals 与懒加载基础。
使用方式:先定义控制器契约,即 targets、values、outlets、actions 和预期生命周期;需要响应式更新时把状态转换放在 value 回调中;对可能在 connect() 完成前运行的回调加保护;用 connect()/disconnect() 成对处理初始化与清理;将 DOM 事件处理与业务规则隔离,保持控制器可组合。按需只打开当前请求所需的参考文件,例如 valueChanged 回调见 references/2023-08-29-stimulus-value-changed-callbacks.md,键盘事件见 references/2023-10-24-stimulus-keyboardevent-101.md,自动排序见 references/2023-12-05-stimulus-auto-sorting.md,outlets 见 references/2023-12-19-stimulus-outlets-api.md,target 回调见 references/2024-05-07-stimulus-target-callbacks.md,Web Share 见 references/2025-11-25-stimulus-web-share-api.md,Core Web Vitals 见 references/2024-06-18-fundamentals-core-web-vitals.md,完整目录见 references/INDEX.md。
限制与边界:优先使用声明式 action 参数而非手动解析 dataset;控制器间通信用 outlets 而非私有内部实现;target 回调需幂等并考虑重复 connect/disconnect;仅在需要 DOM 驱动响应式时使用 MutationObserver;暴露 UI 前先做浏览器 API 特性检测。表单校验、Turbo 导航、实时流、媒体播放和 UX 反馈等应转交相邻技能。