用途:在创建或重构 Stimulus 控制器时提供规范与模式,面向使用 Stimulus.js 和 Hotwire 构建交互式界面的开发者。核心目标是让状态保存在 HTML 中,控制器只添加行为。
主要能力:涵盖控制器附加行为、动作响应 DOM 事件、targets 引用元素、values 通过 data 属性管理状态;强调控制器小而可复用、用数据属性做配置、可组合多个控制器。提供常见模式示例,如下拉菜单、剪贴板控制器以及 Turbo 集成。
使用方式:controller 中用 static targets 与 static values 声明,动作在 HTML 上用 data-action 绑定,支持参数与组合事件如 keydown.enter;全局事件用 @window 或 @document 后缀。建议用 try-catch 处理异步与第三方调用,用 requestSubmit() 提交表单。
适用场景:Dropdown、Clipboard、表单自动提交等交互组件,以及 Turbo 导航下的控制器生命周期管理。限制:资料未提供安装命令、版本要求、平台或收费信息,需以官方文档为准。