Vant 中文入门教程 Vant Circle 环形进度条

2024-02-25 开发教程 Vant 中文入门教程匿名 3℃

引入

import Vue from 'vue';
import { Circle } from 'vant';
Vue.use(Circle);

代码演示

基础用法

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

<van-circle
  v-model="currentRate"
  :rate="30"
  :speed="100"
  :text="text"
/>

export default {
  data() {
    return {
      currentRate: 0
    };
  },
  computed: {
    text() {
      return this.currentRate.toFixed(0) + '%'
    }
  }
};

宽度定制

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

<van-circle
  v-model="currentRate"
  :rate="rate"
  :stroke-width="60"
  text="宽度定制"
/>

颜色定制

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

<van-circle
  v-model="currentRate"
  :rate="rate"
  layer-color="#ebedf0"
  text="颜色定制"
/>

渐变色

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

<van-circle
  v-model="currentRate"
  :rate="rate"
  :color="gradientColor"
  text="渐变色"
/>

export default {
  data() {
    return {
      currentRate: 0,
      gradientColor: {
        '0%': '#3fecff',
        '100%': '#6149f6'
      }
    };
  }
};

逆时针方向

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

<van-circle
  v-model="currentRate"
  :rate="rate"
  :clockwise="false"
  text="逆时针方向"
/>

大小定制

通过size属性设置圆环直径

<van-circle
  v-model="currentRate"
  :rate="rate"
  size="120px"
  text="大小定制"
/>

API

Props

参数	说明	类型	默认值
v-model	当前进度	number	-
rate	目标进度	number \| string	`100`
size	圆环直径，默认单位为 `px`	number \| string	`100px`
color `v2.1.4`	进度条颜色，传入对象格式可以定义渐变色	string \| object	`#1989fa`
layer-color	轨道颜色	string	`white`
fill	填充颜色	string	`none`
speed	动画速度（单位为 rate/s）	number \| string	`0`
text	文字	string	-
stroke-width	进度条宽度	number \| string	`40`
stroke-linecap `v2.2.15`	进度条端点的形状，可选值为`sqaurebutt`	string	`round`
clockwise	是否顺时针增加	boolean	`true`

Slots

名称	说明
default	自定义文字内容

实例演示

上一节： Vant Toast 轻提示

下一节： Vant Collapse 折叠面板

"Vant 中文入门教程"的目录