npm 包 ngx-circle-progress 使用教程

什么是 ngx-circle-progress

ngx-circle-progress 是一个用于构建圆形进度条的 Angular 组件。它内置了多个自定义选项,可以自定义进度条的颜色、厚度、绘制线条的方式以及数值、文字等。

本文针对初学者和有一定经验的前端开发者,介绍如何使用 ngx-circle-progress。

使用方法

步骤一:安装 ngx-circle-progress

首先,我们需要在项目目录下安装 ngx-circle-progress。在终端中执行以下命令:

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

步骤二:导入 ngx-circle-progress

在 Angular 中使用外部库有两种方式:全局导入和按需导入。这里我们采用按需导入的方式。首先需要在模块中导入 ngx-circle-progress:

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

步骤三:在模板中使用 ngx-circle-progress

在模板中添加 ngx-circle-progress:

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

以上代码实现了一个进度为 60%、带标题和数字的圆形进度条。

自定义选项

ngx-circle-progress 提供了大量自定义选项,使用户可以快速构建出自己的进度条。下面对自定义选项进行详细解释:

  • percent (必选):进度百分比,取值范围为 0-100
  • showTitle:是否显示标题,默认为 false
  • title:标题,如果 showTitlefalse,则此选项无效。
  • showSubtitle:是否显示副标题,默认为 false
  • subtitle:副标题,如果 showSubtitlefalse,则此选项无效。
  • color:进度条颜色,默认为 'rgb(52, 152, 219)'
  • background:进度条背景颜色,默认为 'rgb(235, 235, 235)'
  • borderWidth:进度条边框宽度,默认为 0
  • borderColor:进度条边框颜色,默认为 'rgba(204, 204, 204, 0.2)'
  • borderRadius:进度条圆角半径,默认为 0
  • maxPercent:最大进度百分比,如果未设置,则默认等于 percent
  • animations:是否启用动画,默认为 true
  • animationDuration:动画时长(秒),默认为 1
  • units:是否显示单位,默认为 true
  • unitsFontSize:单位字体大小,默认为 16
  • titleFontSize:标题字体大小,默认为 24
  • subtitleFontSize:副标题字体大小,默认为 16
  • circleThickness:圆形进度条的厚度,默认为 4
  • circleFillGap:实心部分与圆形进度条的间隔,默认为 4
  • startAngle:起始角度,默认为 -90(3 点钟方向)。
  • reverse:是否反向绘制进度条,默认为 false(逆时针方向)。
  • responsive: 是否允许响应式布局,默认为 false
  • optimizeGradient: 优化渐变,默认为 false
  • innerStrokeWidth:内圆形进度条宽度,默认为 0,表示不显示。
  • innerStrokeColor:内圆形进度条颜色,默认为 '#f0f0f0'
  • outerStrokeWidth:外圆形进度条宽度,默认为 8
  • outerStrokeColor:外圆形进度条颜色,默认为 '#eaeaea'
  • outerStrokeGradient:是否使用渐变色填充外圆形,默认为 false
  • outerStrokeGradientStops:外圆形进度条渐变停留点,数组的元素是对象,包含 offsetcolor 属性。默认为 [{'offset': 0, 'color': '#3aeabb'}, {'offset': 100, 'color': '#fdd250'}]
  • roundedEdges:是否使用圆角,默认为 false
  • textSize:中心文本的字体大小,默认为 50
  • duration: 单位为 ms,是否使用持续动画,默认为 0
  • animateTitle: 是否使用动画标题,默认为 false
  • animationEase: 动画函数的选择,默认为 easeInOutExpo

示例代码

以下为一个包含进度条和滑动条的 Angular 组件。进度条的数值由滑动条决定。

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

总结

本文介绍了 ngx-circle-progress 的使用方法和相关自定义选项。通过设置不同的参数,我们可以快速创建出符合项目需要的进度条。同时,本文还展示了 ngx-circle-progress 的示例代码,希望能帮助读者更好地理解 ngx-circle-progress。

来源:JavaScript中文网 ,转载请联系管理员! 本文地址:https://www.javascriptcn.com/post/60065f81238a385564ab6b8e


猜你喜欢

  • npm 包 egg-bookshelf 使用教程

    前言 egg-bookshelf 是一款基于 Egg.js 的 ORM 框架,提供了类似于 Ruby on Rails 中 ActiveRecord 功能。它可以让前端开发者更加方便地与数据库交互,使...

    3 年前
  • npm 包 flacheql 使用教程

    前言 随着前端技术的发展,前端工程化变得越来越重要。在前端工程化领域,npm 是广泛使用的包管理工具之一。在 npm 上,有许多优秀的第三方包可以帮助我们提高开发效率和代码质量。

    3 年前
  • npm 包 indexed-db-as-promised 使用教程

    什么是 indexed-db-as-promised indexed-db-as-promised 是一个 npm 包,它提供了一个简单易用的 API 来在前端页面中访问浏览器内置的 indexedD...

    3 年前
  • npm 包 testcafe-reporter-slack-errors 使用教程

    简介 testcafe-reporter-slack-errors 是一个可以将 TestCafe 测试中的错误信息发送到 Slack 的 npm 包。这个工具可以帮助团队更好地跟踪测试结果,及时发现...

    3 年前
  • npm 包 db-devcamp-js-footer 使用教程

    简介 db-devcamp-js-footer 是一个开源的前端库,用于在网页底部添加一个固定的页脚。该库使用简单,方便于大家快速构建美观的网页。 安装 在使用该库之前,我们需要先安装 npm 包。

    3 年前
  • npm 包 duil 使用教程

    什么是 duil duil 是一个基于 Vue.js 的前端组件库,它提供了一些常见的 UI 组件,如按钮、输入框、表格等,可以方便地集成到你的前端项目中。duil 还提供了许多可扩展的插件和主题,可...

    3 年前
  • npm 包 etool-build 使用教程

    前言 etool-build 是一款基于 webpack 打包工具的前端自动化构建工具,它提供了一系列可扩展的插件,可以非常方便地进行前端工程化开发。 在使用 etool-build 之前,你需要掌握...

    3 年前
  • npm 包 ng-diff-match-patch-att 使用教程

    ng-diff-match-patch-att 是一个基于 diff-match-patch 的 AngularJS 库,用于在两个字符串之间进行比较,并显示出包含更改的部分。

    3 年前
  • npm 包 simple-random-string 使用教程

    在前端开发中,随机字符串是一个经常使用的功能,而 npm 包 simple-random-string 可以帮我们轻松生成随机字符串,下面就来详细介绍一下如何使用 simple-random-stri...

    3 年前
  • npm 包 vue-typescript-util 使用教程

    简介 vue-typescript-util 是一个 Vue.js 的 TypeScript 实用工具库,它提供了一些有用的功能和工具,以帮助您更轻松地编写 TypeScript 代码。

    3 年前
  • npm 包 vue-mobile-debug 使用教程

    简介 vue-mobile-debug 是一个针对移动端开发的 Vue 调试工具,其作用在于方便开发者在移动设备上进行 Vue 项目的调试和测试。vue-mobile-debug 是一个基于本地服务器...

    3 年前
  • npm 包 @finndropstudios/eslint-config 使用教程

    介绍 @finndropstudios/eslint-config 是一种 ESLint 配置,它提供了一组规则,以便您能够在您的项目中使用标准的 JavaScript 代码风格。

    3 年前
  • npm 包 @finndropstudios/stylelint-config 使用教程

    介绍 stylelint 是一个强大的 CSS linter,可以帮助开发者规范化编写 CSS 代码。而 @finndropstudios/stylelint-config 则是一种 stylelin...

    3 年前
  • npm 包 cjs4esm 使用教程

    在前端开发中,我们常常使用各种 npm 包来帮助开发和优化效率。然而,在使用这些 npm 包的过程中,我们可能会遇到一些问题,例如代码兼容性等。 cjs4esm 包可以帮助我们将 CommonJS 模...

    3 年前
  • npm 包 i18n-yummy 使用教程

    在进行多语言开发时,常常需要使用到国际化库,而 i18n-yummy 正是一个轻量级的国际化库,高度可定制化,特别适用于 React 资源。 安装 i18n-yummy 你可以通过 npm 进行安装:...

    3 年前
  • npm 包 introspected 使用教程

    在前端开发中,我们常常需要对对象进行检查。introspected 是一款可用于对象检查的 npm 包,提供了丰富的功能方便开发者进行对象的检查和比较操作。 安装 在使用 introspected 进...

    3 年前
  • npm 包 jojo-mock 使用教程

    什么是 jojo-mock? Jojo-mock 是一个用于 模拟( mock ) 后端接口的 npm 包。它可以轻松地帮助前端开发者构建本地开发服务器并提供 mock 数据。

    3 年前
  • npm 包 @coracain/complicated-form-block 使用教程

    概述 @coracain/complicated-form-block 是一个用于 React 前端开发的 npm 包。它提供了一种简单且高效的方式,帮助我们快速构建复杂的表单组件。

    3 年前
  • npm 包 ng2-swipe-cards-reversed 使用教程

    介绍 ng2-swipe-cards-reversed 是一个基于 Angular2+ 的 UI 插件,可以快速创建左右滑动的卡片界面。相较于其它同类插件,ng2-swipe-cards-revers...

    3 年前
  • npm 包 `authebuy` 使用教程

    前言 在现代前端开发中,前后端分离已成为常态,后端提供 API,前端使用 Ajax 等技术请求数据,但是如何保证前端请求 API 的安全性呢?authebuy 就是为了解决这个问题而生的。

    3 年前

相关推荐

    暂无文章