介绍

用于展示操作的当前进度。

引入

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

import { createApp } from 'vue';
import { Progress } from 'vant';

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

代码演示

基础用法

进度条默认为蓝色，使用 ​percentage​ 属性来设置当前进度。

<van-progress :percentage="50" />

线条粗细

通过 ​stroke-width​ 可以设置进度条的粗细。

<van-progress :percentage="50" stroke-width="8" />

置灰

设置 ​inactive​ 属性后进度条将置灰。

<van-progress inactive :percentage="50" />

样式定制

可以使用 ​pivot-text​ 属性自定义文字，​color​ 属性自定义进度条颜色。

<van-progress pivot-text="橙色" color="#f2826a" :percentage="25" />
<van-progress pivot-text="红色" color="#ee0a24" :percentage="50" />
<van-progress
  :percentage="75"
  pivot-text="紫色"
  pivot-color="#7232dd"
  color="linear-gradient(to right, #be99ff, #7232dd)"
/>

API

Props

类型定义

组件导出以下类型定义：

import type { ProgressProps, ProgressInstance } from 'vant';

​ProgressInstance​ 是组件实例的类型，用法如下：

import { ref } from 'vue';
import type { ProgressInstance } from 'vant';

const progressRef = ref<ProgressInstance>();

progressRef.value?.resize();

主题定制

样式变量

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