Circle 环形进度条

引入

app.jsonindex.json中引入组件,详细介绍见快速上手

  1. "usingComponents": {
  2. "van-circle": "path/to/@vant/weapp/dist/circle/index"
  3. }

代码演示

基础用法

value属性表示进度条的目标进度。

  1. <van-circle value="{{ 30 }}" text="text" />

宽度定制

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

  1. <van-circle value="{{ value }}" stroke-width="6" text="宽度定制" />

颜色定制

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

<van-circle
  value="{{ value }}"
  layer-color="#eeeeee"
  color="#ee0a24"
  text="颜色定制"
/>

渐变色

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

<van-circle value="{{ value }}" color="{{ gradientColor }}" text="渐变色" />
Page({
  data: {
    value: 25,
    gradientColor: {
      '0%': '#ffd01e',
      '100%': '#ee0a24'
    }
  }
});

逆时针方向

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

<van-circle
  value="{{ value }}"
  color="#07c160"
  clockwise="{{ false }}"
  text="逆时针"
/>

大小定制

通过size属性设置圆环直径

<van-circle value="{{ value }}" size="120" text="大小定制" />

API

Props

参数说明类型默认值版本
value目标进度number0-
size圆环直径,默认单位为 pxstring | number100-
color进度条颜色,传入对象格式可以定义渐变色string | object#1989fa-
layer-color轨道颜色string#fff-
fill填充颜色string--
speed动画速度(单位为 value/s)number50-
text文字string--
stroke-width进度条宽度number4-
clockwise是否顺时针增加booleantrue-

Slots

名称说明
default自定义文字内容,如果设置了fill,插槽内容会被原生组件覆盖

Circle 进度条 - 图1