npm 包 @bmvantunes/ngprogress 使用教程

阅读时长 5 分钟读完

在前端开发中使用进度条来优化用户交互体验是一种非常常见的方法。npm 包 @bmvantunes/ngprogress 就是一款可以用于 Angular 应用中的轻量级进度条插件。本文将分享如何使用该插件来为你的应用添加进度条,从而提高用户的使用体验。

安装

首先,我们需要使用 Angular 的命令行工具启动一个新的项目。在项目中安装 @bmvantunes/ngprogress:

配置

在 app.module.ts 中导入 NgProgressModule:

-- -------------------- ---- -------
------ - ---------------- - ---- -------------------------

-----------
  ------------- -
    ------------
  --
  -------- -
    --------------
    -----------------
    ----------------
  --
  ---------- ---
  ---------- --------------
--
------ ----- --------- - -

这样就完成了 @bmvantunes/ngprogress 的安装和配置。

使用

基础用法

添加 progress 标签:

在需要使用进度条的地方,导入 NgProgressService,然后使用 start() 和 complete() 方法分别启动和结束进度条:

-- -------------------- ---- -------
------ - --------- - ---- ----------------
------ - ----------------- - ---- -------------------------

------------
  --------- -----------
  ------------ -----------------------
  ---------- ------------------------
--
------ ----- ------------ -
  ------------------- ----------- ------------------ -
    ------------------------
    ------------- -- -
      ---------------------------
    -- ------
  -
-

高级用法

我们可以自定义进度条的颜色、高度和动画时间等。在 app.component.ts 文件中,添加一个 NgProgressConfig 对象来如下定义自定义属性:

-- -------------------- ---- -------
------ - --------- - ---- ----------------
------ - ------------------ ---------------- - ---- -------------------------

------------
  --------- -----------
  ------------ -----------------------
  ---------- ------------------------
--
------ ----- ------------ -
  ------------
    ------- ----------- ------------------
    ------- ------- ----------------
  - -
    ----------------- - ------
    ------------------ - ------
    ------------------- - ------
    ------------------------
    ------------- -- -
      ---------------------------
    -- ------
  -
-

修改颜色、高度和动画时间等属性即可实现自定义效果。

API

方法

  • start():开始进度条;
  • set(n: number):将进度条设为 n%;
  • inc(n?: number):将当前进度条增加 n%(默认为 10%);
  • complete():完成进度条。

属性

  • spinner:设置进度条是否显示加载动画。默认为 true;
  • color:设置进度条和加载动画的颜色。默认为 #35cbff;
  • thick:设置进度条厚度。默认为 3px;
  • ease:设置进度条过渡动画的缓动函数。默认为 ease-out;
  • speed:设置进度条过渡动画的速度。默认为 200ms;
  • trickleSpeed:设置滴答声的间隔。默认为 300ms;
  • trickleFunc:设置滴答声的生成算法。默认返回一个随机数。

总结

@bmvantunes/ngprogress 是一款非常实用的 Angular 进度条插件,可以大大提高用户的使用体验。通过本文的介绍,你已经掌握了如何在 Angular 应用中使用 @bmvantunes/ngprogress 的方法,希望对你的开发工作有所帮助。如果你感兴趣,可以去 npm 官网了解更多关于该插件的用法和更新。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/6005671281e8991b448e35c5

纠错
反馈