项目简介

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

  

面向人群

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

  

组件使用方法及参数解析

<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)"
 >

| 参数名 | 值类型 | 是否必填 | 参数作用 | 默认值 |
| :------: | :------: | :------: | :------: | :------: |
| 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

  <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"
  />

动画原理

• 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;
    }

项目源码及示例

这波组件较为简单，貌似没什么可说的了，就这样吧