Circle 环形进度条

介绍

圆环形的进度条组件，支持进度渐变动画。

基础用法

rate 属性表示进度条的目标进度，v-model:current-rate 表示动画过程中的实时进度。当 rate 发生变化时，v-model:current-rate 会以 speed 的速度变化，直至达到 rate 设定的值。

<z-circle
  v-model:current-rate="currentRate1"
  :rate="rate"
  :speed="100"
  :text="currentRate1.toFixed(0) + '%'"
/>

import { ref } from 'vue'
const rate = ref(70)
const currentRate1 = ref(0)

宽度定制

通过 stroke-width 属性来控制进度条宽度。

<z-circle
  v-model:current-rate="currentRate3"
  :rate="rate"
  :speed="100"
  :stroke-width="10"
  text="宽度定制"
/>

颜色定制

通过 color 属性来控制进度条颜色，layer-color 属性来控制轨道颜色。

<z-circle
  v-model:current-rate="currentRate3"
  color="#ee0a24"
  :rate="rate"
  layer-color="#ebedf0"
  :speed="100"
  text="颜色定制"
/>

渐变色

color 属性支持传入对象格式来定义渐变色。

<z-circle
  v-model:current-rate="currentRate"
  :rate="rate"
  :speed="100"
  :color="gradientColor"
  text="渐变色"
/>

const gradientColor = {
  '0%': '#3fecff',
  '100%': '#6149f6'
}

逆时针方向

将 clockwise 设置为 false，进度会从逆时针方向开始。

<z-circle
  v-model:current-rate="currentRate4"
  color="#07c160"
  :rate="rate"
  :speed="100"
  :clockwise="false"
  text="逆时针"
/>

大小定制

通过 size 属性设置圆环直径。

<z-circle
  v-model:current-rate="currentRate4"
  color="#7232dd"
  :rate="rate"
  :speed="100"
  :size="140"
  text="大小定制"
/>

起始位置

进度条默认从顶部开始，可以通过 start-position 属性设置起始位置。

<z-circle
  v-model:current-rate="currentRate"
  :rate="rate"
  text="左侧"
  start-position="left"
/>
<z-circle
  v-model:current-rate="currentRate"
  :rate="rate"
  text="右侧"
  start-position="right"
/>
<z-circle
  v-model:current-rate="currentRate"
  :rate="rate"
  text="底部"
  start-position="bottom"
/>

Props

Slots

样式变量

组件提供了下列 CSS 变量，可用于自定义样式，使用方法请参考 ConfigProvider 组件。