hwc-ux-feedback

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

User Experience & Feedback

用户体验与反馈

Implement cross-cutting feedback and perceived-performance patterns in Hotwire.
在Hotwire中实现跨领域的反馈与感知性能模式。

Core Workflow

核心工作流程

  1. Identify feedback need: loading, submit activity, progress reporting, optimistic updates, or transitions.
  2. Prefer built-in Turbo semantics first (
    busy
    , progress bar hooks, submit/render lifecycle events).
  3. Add optimistic updates only with a clear reconciliation strategy.
  4. Keep transition logic bounded to explicit lifecycle events and cache/preview-safe paths.
  5. Verify UX behavior on slow network, back/forward cache restores, and submission failures.
  1. 确定反馈需求:加载状态、提交活动、进度报告、Optimistic更新或过渡效果。
  2. 优先使用Turbo内置语义(
    busy
    、进度条钩子、提交/渲染生命周期事件)。
  3. 仅在具备明确协调策略的情况下添加Optimistic更新。
  4. 将过渡逻辑限定在明确的生命周期事件以及缓存/预览安全路径中。
  5. 在慢速网络环境、前进/后退缓存恢复场景以及提交失败场景下验证UX行为。

Guardrails

注意事项

  • Do not use fixed timeouts as a proxy for network or render completion.
  • Gate animations/transitions for previews and cache restores.
  • Keep submit locking/unlocking symmetric between start and end events.
  • Separate UX feedback logic from domain-specific form/media/navigation implementations.
  • 不要使用固定超时来替代网络或渲染完成的判断。
  • 为预览和缓存恢复场景控制动画/过渡效果的触发。
  • 确保提交锁定/解锁在开始与结束事件之间保持对称。
  • 将UX反馈逻辑与特定领域的表单/媒体/导航实现分离。

Load References Selectively

选择性加载参考资料

Open only the file needed for the current request.
  • Turbo progress bar reuse:
    references/2023-07-18-turbo-drive-progress-bar.md
  • Form activity indicators:
    references/2023-06-06-turbo-drive-form-activity-indicators.md
  • Render interception and page transitions:
    references/2023-04-25-turbo-drive-render-interception.md
  • Swiper-like transition behavior:
    references/2024-11-19-turbo-drive-swiper-view-transitions.md
  • Frame busy spinner patterns:
    references/2026-01-20-turbo-frames-loading-spinner.md
  • Optimistic UI with Turbo morph reconciliation:
    references/2024-03-26-optimistic-ui-with-turbo-8-morphs.md
  • ULID-based optimistic identity strategy:
    references/2024-08-13-turbo-drive-ulid.md
Use
references/INDEX.md
for the full catalog.
仅打开当前请求所需的文件。
  • 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协调的Optimistic UI:
    references/2024-03-26-optimistic-ui-with-turbo-8-morphs.md
  • 基于ULID的Optimistic身份策略:
    references/2024-08-13-turbo-drive-ulid.md
完整目录请查看
references/INDEX.md

Escalate to Neighbor Skills

关联技能转接

  • Form validation and submit correctness concerns: use
    hwc-forms-validation
  • Navigation/history/cache flow concerns: use
    hwc-navigation-content
  • Real-time push updates and stream actions: use
    hwc-realtime-streaming
  • Media-specific playback/upload concerns: use
    hwc-media-content
  • General Stimulus API/controller fundamentals: use
    hwc-stimulus-fundamentals
  • 表单验证与提交正确性相关问题:使用
    hwc-forms-validation
  • 导航/历史记录/缓存流程相关问题:使用
    hwc-navigation-content
  • 实时推送更新与流操作相关问题:使用
    hwc-realtime-streaming
  • 媒体专属播放/上传相关问题:使用
    hwc-media-content
  • 通用Stimulus API/控制器基础相关问题:使用
    hwc-stimulus-fundamentals