Vant4 Circle 环形进度条

介绍

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

引入

通过以下方式来全局注册组件，更多注册方式请参考组件注册。

import { createApp } from vue;
import { Circle } from vant;

const app = createApp();
app.use(Circle);

代码演示

基础用法

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

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

import { ref, computed } from vue;

export default {
  setup() {
    const currentRate = ref(0);
    const text = computed(() => currentRate.value.toFixed(0) + %);

    return {
      text,
      currentRate,
    };
  },
};

宽度定制

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

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

颜色定制

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

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

渐变色

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

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

import { ref } from vue;

export default {
  setup() {
    const currentRate = ref(0);
    const gradientColor = {
      0%: #3fecff,
      100%: #6149f6,
    };

    return {
      currentRate,
      gradientColor,
    };
  },
};

逆时针方向

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

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

大小定制

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

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

起始位置

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

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

API

Props

Slots

类型定义

组件导出以下类型定义：

import type { CircleProps, CircleStartPosition } from vant;

主题定制

样式变量

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