Progress 进度条

介绍

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

引入

  1. import { createApp } from 'vue';
  2. import { Progress } from 'vant';
  3. const app = createApp();
  4. app.use(Progress);

代码演示

基础用法

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

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

线条粗细

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

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

置灰

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

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

样式定制

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

  1. <van-progress pivot-text="橙色" color="#f2826a" :percentage="25" />
  2. <van-progress pivot-text="红色" color="#ee0a24" :percentage="50" />
  3. <van-progress
  4. :percentage="75"
  5. pivot-text="紫色"
  6. pivot-color="#7232dd"
  7. color="linear-gradient(to right, #be99ff, #7232dd)"
  8. />

API

Props

参数说明类型默认值
percentage进度百分比number | string0
stroke-width进度条粗细,默认单位为pxnumber | string4px
color进度条颜色string#1989fa
track-color轨道颜色string#e5e5e5
pivot-text进度文字内容string百分比
pivot-color进度文字背景色string同进度条颜色
text-color进度文字颜色stringwhite
inactive是否置灰booleanfalse
show-pivot是否显示进度文字booleantrue

方法

通过 ref 可以获取到 Progress 实例并调用实例方法,详见组件实例方法

方法名说明参数返回值
resize外层元素大小变化后,可以调用此方法来触发重绘--

样式变量

组件提供了下列 Less 变量,可用于自定义样式,使用方法请参考主题定制

名称默认值描述
@progress-height4px-
@progress-color@blue-
@progress-background-color@gray-3-
@progress-pivot-padding0 5px-
@progress-pivot-text-color@white-
@progress-pivot-font-size@font-size-xs-
@progress-pivot-line-height1.6-
@progress-pivot-background-color@blue-

常见问题

组件从隐藏状态切换到显示状态时,渲染不正确?

Progress 组件在挂载时,会获取自身的宽度,并计算出进度条的样式。如果组件一开始处于隐藏状态,则获取到的宽度永远为 0,因此无法展示正确的进度。

解决方法

方法一,如果是使用 v-show 来控制组件展示的,则替换为 v-if 即可解决此问题:

  1. <!-- Before -->
  2. <van-progress v-show="show" />
  3. <!-- After -->
  4. <van-progress v-if="show" />

方法二,调用组件的 resize 方法来主动触发重绘:

  1. <van-progress v-show="show" ref="progress" />
  1. this.$refs.progress.resize();

Progress 进度条 - 图1