SuperAPI AI 工具集

stimulus-patterns

通用与其它

查看项目

更新于 10-16 07:14

技能介绍

用途:为服务端渲染的 Rails 页面添加 JavaScript 行为,做渐进增强而非构建单页应用。适用于 UI 交互(下拉、弹窗、提示)、表单增强(自动提交、校验提示)、DOM 显隐切换与第三方库集成。

主要能力:要求控制器小而单一,多数在 50 行以内;通过 values/classes 配置而非硬编码;支持多控制器同元素、嵌套控制器与事件通信(this.dispatch 发布,data-action 订阅)。

技术栈与用法:Stimulus 3.2+、Turbo 8+、Importmap(无打包器),文件位于 app/javascript/controllers/,可用 bin/rails generate stimulus [name] 生成。命名约定:HTML 用 kebab-case(data-controller="auto-submit"),文件名用 snake_case(auto_submit_controller.js),targets/values/classes 用 camelCase。

性能与清理:事件委托、防抖、在 disconnect() 中清理定时器、观察器与监听器,可用 IntersectionObserver。测试以系统测试为主。

边界:业务逻辑放模型,数据获取与客户端路由交给 Turbo,状态以服务端为准;不构建 SPA、不写 god controller、不硬编码、fetch 时勿忘 CSRF token。资料未提供具体收费、平台与效果信息。