hwc-ux-feedback

用户体验与反馈

在 Hotwire 中实现跨领域的反馈和感知性能模式。

核心工作流

1. 确定反馈需求：加载、提交活动、进度报告、乐观更新或过渡效果。
2. 优先使用内置的 Turbo 语义（busy、进度条钩子、提交／渲染生命周期事件）。
3. 仅在制定了明确的协调策略时才添加乐观更新。
4. 将过渡逻辑限制在明确的生命周期事件和可安全用于缓存／预览的路径中。
5. 在慢速网络、前进／后退缓存恢复和提交失败的情况下验证用户体验。

防护措施

• 不要用固定超时时间代替网络或渲染完成状态。
• 在预览和缓存恢复时禁用动画／过渡效果。
• 确保提交锁定和解锁在开始与结束事件之间对称。
• 将用户体验反馈逻辑与特定领域的表单／媒体／导航实现分开。

按需加载参考资料

仅打开当前请求所需的文件。

• 复用 Turbo 进度条：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
• 类似 Swiper 的过渡行为：references/2024-11-19-turbo-drive-swiper-view-transitions.md
• Frame 忙碌状态旋转指示器模式：references/2026-01-20-turbo-frames-loading-spinner.md
• 使用 Turbo morph 协调乐观 UI：references/2024-03-26-optimistic-ui-with-turbo-8-morphs.md
• 基于 ULID 的乐观身份策略：references/2024-08-13-turbo-drive-ulid.md
• 表单提交加载状态：references/2026-03-10-turbo-frames-form-loading-states.md
• Frame 错误边界和重试：references/2026-04-28-turbo-frames-error-boundaries.md
• 共享元素视图过渡：references/2026-05-12-turbo-drive-shared-element-view-transitions.md
• 自动保存的乐观 Toast 通知：references/2026-05-26-stimulus-optimistic-toast-auto-save.md

完整目录请参阅 references/INDEX.md。

转交给相邻技能

• 表单验证和提交正确性相关问题：使用 hwc-forms-validation
• 导航／历史记录／缓存流程相关问题：使用 hwc-navigation-content
• 实时推送更新和流操作相关问题：使用 hwc-realtime-streaming
• 特定于媒体的播放／上传相关问题：使用 hwc-media-content
• 通用 Stimulus API／控制器基础知识：使用 hwc-stimulus-fundamentals