vant/docs/examples-docs/steps.md

Steps 步骤条

使用指南

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

全局注册

你可以在全局注册Steps组件，比如页面的主文件（index.js，main.js），这样页面任何地方都可以直接使用Steps组件了：

import Vue from 'vue';
import { Steps, Step } from 'vant';
import 'vant/lib/vant-css/steps.css';

Vue.component(Steps.name, Steps);
Vue.component(Step.name, Step);

局部注册

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

import { Steps, Step } from 'vant';
import 'vant/lib/vant-css/steps.css';

export default {
  components: {
    'van-steps': Steps,
    'van-step': Step
  }
};

代码演示

基础用法

:::demo 基础用法

<van-steps :active="active" icon="logistics" icon-class="steps-success" title="等待商家发货" description="等待商家发货等待商家发货等待商家发货等待商家发货等待商家发货">
  <van-step>买家下单</van-step>
  <van-step>商家接单</van-step>
  <van-step>买家提货</van-step>
  <van-step>交易完成</van-step>
</van-steps>

<van-button @click="nextStep">下一步</van-button>

<script>
export default {
  data() {
    return {
      active: 0
    };
  },

  methods: {
    nextStep() {
      if (++this.active > 3) this.active = 0;
    }
  }
}
</script>

:::

只显示步骤条

当你不设置title或description属性时，就会只显示步骤条，而没有步骤的详细信息。

:::demo 只显示步骤条

<van-steps :active="active">
  <van-step>买家下单</van-step>
  <van-step>商家接单</van-step>
  <van-step>买家提货</van-step>
  <van-step>交易完成</van-step>
</van-steps>

:::

竖式步骤条

可以通过设置direction属性来改变步骤条的显示方式，可选值有vertical/horizontal。

:::demo 只显示步骤条

<van-steps direction="vertical" :active="0" active-color="#f60">
  <van-step>
    <h3>【城市】最新的物流状态之类的表述哈哈哈哈</h3>
    <p>2016-07-12 12:12:12</p>
  </van-step>
  <van-step>
    <h3>【城市】已经过了的物流状态我是折行我是折行我是折行联系电话：158630099999</h3>
    <p>2016-07-12 12:12:12</p>
  </van-step>
  <van-step>
    <h3>未发货</h3>
    <p>2016-07-12 12:12:12</p>
  </van-step>
</van-steps>

:::

高级用法

可以使用具名slot增加自定义内容，其中包含icon和message-extra。

:::demo 高级用法

<van-steps :active="active" title="等待商家发货">
  <van-icon slot="icon" name="like"></van-icon>
  <p slot="message-extra">流程</p>
  <van-step>买家下单</van-step>
  <van-step>商家接单</van-step>
  <van-step>买家提货</van-step>
  <van-step>交易完成</van-step>  
</van-steps>

:::

Steps API

参数	说明	类型	默认值	可选值
active	当前激活的步骤，从0开始	number
icon	当前步骤的icon	string
iconClass	当前步骤栏为icon添加的类	string
title	当前步骤从标题	string
description	当前步骤描述	string
direction	显示方向	string	horizontal	vertical/horizontal
activeColor	active状态时的颜色	string	#06bf04

Steps Slot

名称	说明
icon	自定义icon区域
message-extra	状态栏添加额外的元素