用途:在 Hotwire 应用中实现跨切面的反馈与“感知性能”模式,包括加载状态、提交活动指示、进度上报、乐观更新和页面过渡。
主要能力:先用 Turbo 内置语义(busy、进度条钩子、submit/render 生命周期事件);仅在具备清晰对账策略时添加乐观更新;把过渡逻辑限制在显式的生命周期事件与缓存/预览安全路径内;在慢网络、前进后退缓存恢复与提交失败场景下验证 UX 行为。
使用方式:按当前需求选择性打开参考文件,例如进度条复用 references/2023-07-18-turbo-drive-progress-bar.md,表单活动指示 references/2023-06-06-turbo-drive-form-activity-indicators.md,渲染拦截与页面过渡 references/2023-04-25-turbo-drive-render-interception.md,morph 对账的乐观 UI references/2024-03-26-optimistic-ui-with-turbo-8-morphs.md,ULID 乐观标识 references/2024-08-13-turbo-drive-ulid.md;完整目录见 references/INDEX.md。
限制与护栏:不得用固定超时替代网络或渲染完成信号;需为预览与缓存恢复关闭动画/过渡;提交锁定与解锁须在起始与结束事件间保持对称;将 UX 反馈逻辑与具体表单/媒体/导航实现分离。表单校验、导航历史、实时推送、媒体播放与 Stimulus 基础分别交由相邻技能处理。具体安装命令暂未提供。