vue 圆形进度条组件解析

最新推荐文章于 2024-04-08 09:48:37 发布

youyo2113

最新推荐文章于 2024-04-08 09:48:37 发布

阅读量914

点赞数

文章标签： vue 圆形进度条

项目简介

本组件是vue下的圆形进度条动画组件
自由可定制，几乎全部参数均可设置
源码简单清晰

面向人群

急于使用vue圆形进度条动画组件的同学。直接下载文件，拷贝代码即可运行。
喜欢看源码，希望了解组件背后原理的同学。
刚接触前端的同学也可以通过本文章养成看源码的习惯。打破对源码的恐惧，相信自己，其实看源码并没有想象中的那么困难

组件使用方法及参数解析


 &lt;circle-progress
   :id="1"
   :width="200"
   :radius="20"
   :progress="70"
   :delay="200"
   :duration="1000"
   :barColor="#F2AE57"
   :backgroundColor="#FFE8CC"
   :isAnimation="true"
   :timeFunction="cubic-bezier(0.99, 0.01, 0.22, 0.94)"
 &gt;

| 参数名 | 值类型 | 是否必填 | 参数作用 | 默认值 |
| :------: | :------: | :------: | :------: | :------: |
| id | String | 选填 | 组件的id，多次定义设置不同的值 | 1 |
| width | Number | 必填 | 设置圆整体的大小，单位为px | 无 |
| radius | Number | 必填 | 设置进度条宽度，单位为px | 无 |
| progress | Number | 必填 | 设置进度百分比 | 无 |
| barColor | String | 必填 | 设置进度条颜色 | 无 |
| backgroundColor | String | 必填 | 设置进度条背景颜色 | 无 |
| delay | Number | 选填 | 延迟多久执行，单位为ms | 20 |
| duration | Number | 选填 | 动画整体时长，单位为ms | 1000 |
| timeFunction | String | 选填 | 动画缓动算法 | cubic-bezier(0.99, 0.01, 0.22, 0.94) |
| isAnimation | Boolean | 选填 | 是否以动画的方式呈现 | true |

原理解析

圆形的绘画

使用的是svg技术进行绘画
原理很简单，就是两个圆的折叠显示，这里重点讲的是svg标签各属性的意义
r：圆的半径
cy：圆点的 y 坐标
cx：圆点的 x 坐标
stroke：画笔颜色
stroke-width：画笔宽度
stroke-linecap：画笔结束方式，是圆形结束还是垂直结束
stroke-dasharray：需要点数字，如果只设置一个值，则仅生成一条线的虚线，从而实现画直线
stroke-dashoffset：定义虚线开始的地方，即虚线的位移。从而隐藏一部分虚线，实现显示弧线的效果。动画的原理也是利用该属性，控制隐藏的部分，实现进度条的增长
fill：填充的图案或者颜色，由于这里直接使用画笔描绘图形，所以用不上，为了覆盖其默认值black，设置为none


&lt;circle ref="$bar"
  :r="(width-radius)/2"
  :cy="width/2"
  :cx="width/2"
  :stroke="barColor"
  :stroke-width="radius"
  :stroke-linecap="isRound ? 'round' : 'square'"
  :stroke-dasharray="(width-radius)*3.14"
  :stroke-dashoffset="isAnimation ? (width-radius) * 3.14 : (width - radius) * 3.14 * (100 - progress) / 100"
  fill="none"
/&gt;

动画原理

css3的animation动画。
由于动画关键帧「keyframes」的定义需要根据外部传入的参数决定，不能预先写死。
所以通过生成style节点的方式插入关键帧。
在组件beforeDestroy时，将生成的style节点删除掉。方式是通过给style节点添加id属性进行定位。
动画是通过修改stroke-dashoffset的值实现，设置不同的stroke-dashoffset值，可以控制圆弧隐藏的内容
完全隐藏时，stroke-dashoffset值即圆形进度条的周长
stroke-dashoffset除了在节点属性中设置，也可以通过css样式设置


  @keyframes circle_progress_keyframes_name_1 {
    from {
      stroke-dashoffset: 565.2px;
    }
    to {
      stroke-dashoffset: 169.56px;
    }
  }
  .circle_progress_bar1 {
    animation: circle_progress_keyframes_name_1 1000ms 20ms cubic-bezier(0.99, 0.01, 0.22, 0.94) forwards;
  }