Agent Skills
返回列表
顶部加载细条

顶部加载细条

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_f1b049da/aeac2026556。

技能介绍

解决Web交互中的等待焦虑

在处理列表刷新、保存请求或路由切换时,如果异步操作没有明显的视觉反馈,应用就会表现出一种“卡死”的假象,用户体验也会大打折扣。借鉴 YouTube 和 Medium 的设计,引入一个轻量级的顶部进度条(Top Loading Bar)能够有效缓解这一现象。

该技能基于轻量级库 nprogress,通过封装好的 withTopProgress 函数,为全局请求或页面切换提供极简的加载指示,避免用户因不确定的等待时间而产生焦虑。

核心设计与实施步骤

这套方案保持了极简的接入路径:

  • 封装封装层:引入 nprogress 及其 CSS 后,将请求逻辑封装进 withTopProgress。
  • 统一生命周期:在发起异步请求或路由切换前调用 start(),执行完成后或进入 finally 块中时必须配对调用 done()。
  • 恶意遗漏检查:必须确保异常路径(如请求报错)状态下也能触发 done(),防止顶部细条永久驻留。

边界与避坑指南

在使用该方案时,需要注意其硬约束和适用边界:

  • 仅做指示,不做遮罩:该细条仅作为轻量级的视觉提示,不应与全屏遮罩叠加,以免产生视觉干扰。
  • 避免裸调用:严禁只调用 start 而忘记调用 done,这会导致页面顶部长期存在一道细杠。
  • 范围限制:此技能不符合复杂的多进度任务编排或完整的骨架屏需求,它仅仅是为了提供一种全局且轻量的 Demo 级视觉反馈。

使用场景

  • 在单页应用中使用路由钩子时,需要在切换页面的间隙快速显示一个细条表示正在跳转。
  • 在开发者提交保存或刷新请求时,用极细的顶部细条提示后台处理中,同时不遮挡表单内容。
  • 当构建轻量级的全局加载演示且不想引入大型遮罩组件时,调用该技能启动并完成顶部进度。

适合人员

  • 前端开发者,需要在表单提交或列表刷新等异步操作期间提供极简的视觉反馈。
  • 单页应用维护者,希望在路由切换过渡中加入类似 YouTube 或 Medium 风格的顶部细条。
  • 全栈工程师,寻求用 `nprogress` 封装一个适用于多个异步请求的全局轻量级加载辅助工具。