Progress 进度条

展示操作的当前进度。

何时使用

在操作需要较长时间才能完成时,为用户显示该操作的当前进度和状态。

  • 当一个操作会打断当前界面,或者需要在后台运行,且耗时可能超过2秒时;
  • 当需要显示一个操作完成的百分比时。

代码演示

进度条

标准的进度条。

  1. <v-progress-line :percent="30"></v-progress-line>
  2. <v-progress-line :percent="50" status="active"></v-progress-line>
  3. <v-progress-line :percent="70" status="exception"></v-progress-line>
  4. <v-progress-line :percent="100"></v-progress-line>
  5. <v-progress-line :percent="50" :show-info="false"></v-progress-line>

小型进度条

适合放在较狭窄的区域内。

  1. <v-progress-line :percent="30" :stroke-width="5"></v-progress-line>
  2. <v-progress-line :percent="50" :stroke-width="5" status="active"></v-progress-line>
  3. <v-progress-line :percent="70" :stroke-width="5" status="exception"></v-progress-line>
  4. <v-progress-line :percent="100" :stroke-width="5"></v-progress-line>

自定义文字格式

format 属性指定格式。

  1. <v-progress-line :percent="75" :format="percent => `${percent}天`"></v-progress-line>
  2. <v-progress-line :percent="100" :format="() => '完成'"></v-progress-line>

进度圈

圈形的进度。

  1. <v-progress-circle :percent="75" :stroke-width="3"></v-progress-circle>
  2. <v-progress-circle :percent="70" status="exception"></v-progress-circle>
  3. <v-progress-circle :percent="100"></v-progress-circle>

小型进度圈

小一号的圈形进度。

  1. <v-progress-circle :percent="30" :width="80"></v-progress-circle>
  2. <v-progress-circle :percent="70" :width="80" status="exception"></v-progress-circle>
  3. <v-progress-circle :percent="100" :width="80"></v-progress-circle>

自定义文字格式

format 属性指定格式。

  1. <v-progress-circle :percent="75" :format="percent => `${percent}天`"></v-progress-circle>
  2. <v-progress-circle :percent="100" :format="() => '完成'"></v-progress-circle>

仪表盘

仪表盘样式的进度条。

  1. <v-progress-circle dashboard :percent="75"></v-progress-circle>

API

ProgressLine Props

参数说明类型默认值
percent百分比Number0
format内容的模板函数String/Function(percent)-
status状态,可选:success exception active normalStringnormal
showInfo是否显示进度数值或状态图标Booleantrue
infoColor进度数值或状态图标的颜色String-
strokeWidth进度条线的宽度,单位 pxNumber10
normalColor自定义进度normal时的颜色String#108ee9
activeColor自定义进度active时的颜色String#108ee9
exceptionColor自定义进度exception时的颜色String#f04134
successColor自定义进度success时的颜色String#00a854
trailColor进度背景颜色String#f7f7f7

ProgressCircle Props

参数说明类型默认值
percent百分比Number0
format内容的模板函数String/Function(percent)-
status状态,可选:success exception normalStringnormal
showInfo是否显示进度数值或状态图标Booleantrue
infoColor进度数值或状态图标的颜色String-
strokeWidth圆形进度条线的宽度,单位是进度条画布宽度的百分比Number6
width圆形进度条画布宽度,单位 pxNumber132
normalColor自定义进度圈normal时的颜色String#108ee9
exceptionColor自定义进度圈exception时的颜色String#f04134
successColor自定义进度圈success时的颜色String#00a854
trailColor进度圈背景颜色String#f7f7f7
dashboard是否是仪表盘样式Booleanfalse