Steps 步骤条

介绍

用于展示操作流程的各个环节,让用户了解当前的操作在整体流程中的位置。

引入

app.jsonindex.json中引入组件,详细介绍见快速上手

  1. "usingComponents": {
  2. "van-steps": "@vant/weapp/steps/index"
  3. }

代码演示

基础用法

  1. <van-steps steps="{{ steps }}" active="{{ active }}" />
  1. Page({
  2. data: {
  3. steps: [
  4. {
  5. text: '步骤一',
  6. desc: '描述信息',
  7. },
  8. {
  9. text: '步骤二',
  10. desc: '描述信息',
  11. },
  12. {
  13. text: '步骤三',
  14. desc: '描述信息',
  15. },
  16. {
  17. text: '步骤四',
  18. desc: '描述信息',
  19. },
  20. ],
  21. },
  22. });

自定义样式

可以通过 active-iconactive-color 属性设置激活状态下的图标和颜色。

  1. <van-steps
  2. steps="{{ steps }}"
  3. active="{{ active }}"
  4. active-icon="success"
  5. active-color="#38f"
  6. />

自定义图标

可以通过 inactiveIconactiveIcon 属性分别设置每一项的图标。

  1. <van-steps steps="{{ steps }}" active="{{ active }}" />
  1. Page({
  2. data: {
  3. steps: [
  4. {
  5. text: '步骤一',
  6. desc: '描述信息',
  7. inactiveIcon: 'location-o',
  8. activeIcon: 'success',
  9. },
  10. {
  11. text: '步骤二',
  12. desc: '描述信息',
  13. inactiveIcon: 'like-o',
  14. activeIcon: 'plus',
  15. },
  16. {
  17. text: '步骤三',
  18. desc: '描述信息',
  19. inactiveIcon: 'star-o',
  20. activeIcon: 'cross',
  21. },
  22. {
  23. text: '步骤四',
  24. desc: '描述信息',
  25. inactiveIcon: 'phone-o',
  26. activeIcon: 'fail',
  27. },
  28. ],
  29. },
  30. });

竖向步骤条

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

  1. <van-steps
  2. steps="{{ steps }}"
  3. active="{{ active }}"
  4. direction="vertical"
  5. active-color="#ee0a24"
  6. />

API

Steps Props

参数说明类型默认值版本
active当前步骤number0-
direction显示方向,可选值为 horizontal verticalstringhorizontal-
active-color激活状态颜色string#07c160-
inactive-color未激活状态颜色string#969799-
active-icon激活状态底部图标,可选值见 Icon 组件stringchecked-
inactive-icon未激活状态底部图标,可选值见 Icon 组件string--

Events

事件名称说明回调参数
bind:click-step点击步骤时触发的事件event.detail:当前步骤的索引

外部样式类

类名说明
custom-class根节点样式类
desc-class描述信息样式类

Steps 步骤条 - 图1