vant/docs/examples-docs/progress.md
2017-04-19 17:44:57 +08:00

3.1 KiB
Raw Blame History

Progress 进度条

使用指南

如果你已经按照快速上手中引入了整个vant,以下组件注册就可以忽略了,因为你已经全局注册了vant中的全部组件。

全局注册

你可以在全局注册Progress组件,比如页面的主文件(index.jsmain.js),这样页面任何地方都可以直接使用Progress组件了:

import Vue from 'vue';
import { Progress } from 'vant';
import 'vant/lib/vant-css/progress.css';

Vue.component(Progress.name, Progress);

局部注册

如果你只是想在某个组件中使用,你可以在对应组件中注册Progress组件,这样只能在你注册的组件中使用Progress

import { Progress } from 'vant';

export default {
  components: {
    'van-progress': Progress
  }
};

代码演示

基础用法

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

:::demo 基础用法

<div class="demo-progress__wrapper">
  <van-progress class="demo-progress__demo1" :percentage="0"></van-progress>
</div>
<div class="demo-progress__wrapper">
  <van-progress class="demo-progress__demo2" :percentage="46"></van-progress>
</div>
<div class="demo-progress__wrapper">
  <van-progress class="demo-progress__demo1" :percentage="100"></van-progress>
</div>

:::

Inactive

是否置灰进度条,一般用于进度条被取消时。

:::demo Inactive

<div class="demo-progress__wrapper">
  <van-progress class="demo-progress__demo1" :inactive="true" :percentage="0"></van-progress>
</div>
<div class="demo-progress__wrapper">
  <van-progress class="demo-progress__demo2" :inactive="true" :percentage="46"></van-progress>
</div>
<div class="demo-progress__wrapper">
  <van-progress class="demo-progress__demo1" :inactive="true" :percentage="100"></van-progress>
</div>

:::

自定义颜色和文字

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

:::demo 自定义颜色和文字

<div class="demo-progress__wrapper">
  <van-progress class="demo-progress__demo1" pivot-text="红色" color="#ed5050" :percentage="26"></van-progress>
</div>
<div class="demo-progress__wrapper">
  <van-progress class="demo-progress__demo1" pivot-text="橙色" color="#f60" :percentage="46"></van-progress>
</div>
<div class="demo-progress__wrapper">
  <van-progress class="demo-progress__demo1" pivot-text="黄色" color="#f09000" :percentage="66"></van-progress>
</div>

:::

API

参数 说明 类型 默认值 可选值
inactive 是否置灰 boolean false true, false
percentage 进度百分比 number false 0-100
pivotText 文字显示 string 百分比文字 -
color 进度条颜色 string #38f hexvalue
textColor 进度条文字颜色 string #fff hexvalue