3.1 KiB
Raw Blame History

Steps 步骤条

使用指南

import { Step, Steps } from 'vant';

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

代码演示

基础用法

:::demo 基础用法

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

<van-button @click="nextStep">下一步</van-button>
export default {
  data() {
    return {
      active: 0
    };
  },

  methods: {
    nextStep() {
      this.active = ++this.active % 4;
    }
  }
}

:::

物流描述

通过titledescription属性来定义物流描述信息

:::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>

:::

竖向步骤条

可以通过设置direction属性来改变步骤条的显示方式

:::demo 竖向步骤条

<van-steps direction="vertical" :active="0" active-color="#f60">
  <van-step>
    <h3>【城市】物流状态1</h3>
    <p>2016-07-12 12:40</p>
  </van-step>
  <van-step>
    <h3>【城市】物流状态2</h3>
    <p>2016-07-11 10:00</p>
  </van-step>
  <van-step>
    <h3>快件已发货</h3>
    <p>2016-07-10 09:30</p>
  </van-step>
</van-steps>

:::

高级用法

使用slot增加自定义内容

:::demo 高级用法

<van-steps :active="active" title="等待商家发货">
  <van-icon slot="icon" name="location"></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
activeColor active状态颜色 String #06bf04

Steps Slot

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