用途:在 Rails 应用中用 Hotwire/Turbo 构建实时响应式 UI,不引入 React、Vue 或 Alpine 等前端框架。核心思路是服务端渲染 HTML,用 Turbo Streams、Turbo Frames 与 morphing 完成局部更新与实时刷新。
主要能力:支持七种 Turbo Stream 动作(append、prepend、replace、update、remove、before、after),以及保留焦点、滚动与状态的 morph;支持 Turbo Frame 懒加载、内联编辑、模态框与命名目标;支持通过模型广播配合 ActionCable/Solid Cable 向其他用户推送实时更新;提供 dom_id、turbo_stream_from 订阅、flash 消息与多段更新的写法。
使用方式:控制器中 respond_to 同时提供 turbo_stream 与 html 回退;视图用 turbo_stream.* 生成流响应;表单与链接通过 data-turbo-frame 指定 _top、_self 或命名 frame;全局 morph 可用 meta 标签 turbo-refresh-method 与 turbo-refresh-scroll 开启,元素级可用 data-turbo-permanent。常用命令包括 bin/dev、bin/rails test:system,以及用 curl 带 Accept: text/vnd.turbo-stream.html 请求验证流响应。
适用场景:用户操作后的局部页面更新、滚动或可见时懒加载、内联编辑、面向其他用户的实时更新、需保留表单状态的复杂更新、整页平滑过渡与模态框。
限制与注意:不应与客户端渲染框架混用;不要遗漏 Turbo Stream 格式响应;避免对每次微小变化都广播,应做防抖;需正确使用 turbo_stream_from 订阅;向大量用户广播前应先评估性能。资料未提供具体版本兼容范围、收费与平台信息。