SuperAPI AI 工具集

hwc-navigation-content

通用与其它

查看项目

更新于 10-16 00:01

技能介绍

用途:在 Hotwire 场景下实现导航与内容发现行为,基于 Turbo Drive 和 Turbo Frames,覆盖标签页、分页、懒加载、分面搜索以及自定义渲染与缓存生命周期。

主要能力:核心流程是先归类导航模式(标签页、分页、懒帧加载、分面搜索或自定义渲染/缓存生命周期),再确定 URL 与历史记录归属(data-turbo-action、frame src、查询参数、前进后退行为),随后利用 frame 生命周期和访问事件更新激活状态、请求参数与滚动位置恢复,在 Turbo 缓存快照前清理临时 UI 状态,并验证前进/后退导航与刷新路径下的行为。

使用方式:按当前需求选择性加载参考资料,例如标签页 frame 导航、分页与历史管理、懒加载 frame 生命周期、滚动位置恢复、Turbo Drive 缓存生命周期、自定义渲染拦截、条件即时点击策略、结合 Stimulus 的分面搜索以及 Markdown 预览流程,完整目录见 references/INDEX.md。表单提交与校验应转向 hwc-forms-validation,推送式实时更新转向 hwc-realtime-streaming,媒体交互设计转向 hwc-media-content,通用反馈与性能体验转向 hwc-ux-feedback,非导航类 Stimulus API 基础转向 hwc-stimulus-fundamentals。

限制与注意:应在加载/渲染事件而非点击意图事件上更新激活与标签状态;筛选和分页需要保持 URL 状态规范;避免将临时 UI 痕迹留在缓存快照中;懒加载需谨慎使用并验证加载边界与观察器行为。具体参数、代码与安装方式暂未提供。