Progress 进度条

介绍

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

代码演示

基础用法

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

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

线条粗细

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

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

置灰

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

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

样式定制

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

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

API

Props

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

主题定制

样式变量

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

名称默认值描述
--z-progress-height8rpx-
--z-progress-colorvar(--z-primary-color)-
--z-progress-inactive-colorvar(--z-gray-5)-
--z-progress-backgroundvar(--z-gray-3)-
--z-progress-pivot-padding0 10rpx-
--z-progress-pivot-text-colorvar(--z-white)-
--z-progress-pivot-font-sizevar(--z-font-size-xs)-
--z-progress-pivot-line-height1.6-
--z-progress-pivot-backgroundvar(--z-primary-color)-