步骤条 Steps

拆分某项流程的步骤,引导用户按流程完成任务。

步骤条包含 2 个组件: stepsstep ,这两个组件必须同时在使用页面引入。

基础用法

step组件用于设置每一个步骤条元素的内容。

通过titledescribe属性分别设置步骤条元素的标题和描述内容。

示例代码

aa

  1. <l-steps>
  2. <l-step title="已支付" describe="11:30"></l-step>
  3. <l-step title="备餐中" describe="11:30"></l-step>
  4. <l-step title="已出餐" describe="11:30"></l-step>
  5. </l-steps>

设置步骤条进度

通过active-index设置初始步骤条进度。默认值为0

示例代码

  1. <l-steps active-index="1">
  2. <l-step title="已支付" describe="11:30"></l-step>
  3. <l-step title="备餐中" describe="11:30"></l-step>
  4. <l-step title="已出餐" describe="11:30"></l-step>
  5. </l-steps>

设置步骤条方向及步骤条元素的最小高度

通过direction属性设置步骤条方向。可选值为rowcolumn,默认为row

direction属性为column是可通过设置step-min-height属性更改步骤条元素的最小高度,该高度包括右侧内容高度,同时可撑高线的高度。默认为120,单位为rpx

示例代码

a

  1. <l-steps direction="column" step-min-height="160">
  2. <l-step title="已支付" describe="11:30"></l-step>
  3. <l-step title="备餐中" describe="11:30"></l-step>
  4. <l-step title="已出餐" describe="11:30"></l-step>
  5. </l-steps>

设置步骤条排序

通过reverse属性为true可设置步骤条为倒序排列。默认为正序排列。

示例代码

aaa

  1. <l-steps reverse="{{true}}" direction="column" step-min-height="160">
  2. <l-step title="已支付" describe="11:30"></l-step>
  3. <l-step title="备餐中" describe="11:30"></l-step>
  4. <l-step title="已出餐" describe="11:30"></l-step>
  5. </l-steps>

设置步骤条状态

通过status属性设置步骤条当前选中元素的状态。可选值为processerror,默认为process

示例代码

a

  1. <l-steps active-index="1" status="error">
  2. <l-step title="已支付" describe="11:30"></l-step>
  3. <l-step title="备餐中" describe="11:30"></l-step>
  4. <l-step title="已出餐" describe="11:30"></l-step>
  5. </l-steps>

点状步骤条

通过dot属性设置步骤条为点状步骤条。默认值为fasle

示例代码

a

  1. <l-steps dot="{{true}}">
  2. <l-step title="已支付" describe="11:30"></l-step>
  3. <l-step title="备餐中" describe="11:30"></l-step>
  4. <l-step title="已出餐" describe="11:30"></l-step>
  5. </l-steps>

步骤条图标

通过icon属性设置步骤条元素的图标,仅在dottrue的条件下生效。

通过icon-sizeicon-color属性设置步骤条元素的图标的大小和颜色。

示例代码

a

  1. <l-steps dot="{{true}}">
  2. <l-step icon="cart" title="已支付" describe="11:30"></l-step>
  3. <l-step title="备餐中" describe="11:30"></l-step>
  4. <l-step title="已出餐" describe="11:30"></l-step>
  5. </l-steps>

步骤条激活态颜色

通过color属性设置步骤条激活状态的颜色。

示例代码

aaa

  1. <l-steps color="48a7e3">
  2. <l-step icon="cart" title="已支付" describe="11:30"></l-step>
  3. <l-step title="备餐中" describe="11:30"></l-step>
  4. <l-step title="已出餐" describe="11:30"></l-step>
  5. </l-steps>

自定义(步骤条节点 || 描述内容)

通过设置插槽的slotdotdescribe分别自定义步骤条节点和描述内容,自定义步骤条节店内容需同时设置custom属性为true

示例代码

b

  1. <!-- 自定义步骤条节点 -->
  2. <l-steps>
  3. <l-step title="已支付" describe="11:30" />
  4. <l-step title="备餐中" describe="12:30" />
  5. <l-step custom="{{true}}" title="已收货" describe="11:30">
  6. <view class="shou" slot="dot"></view>
  7. </l-step>
  8. </l-steps>
  9. <!-- 自定义描述内容 -->
  10. <l-steps direction="column" active-index="1">
  11. <l-step title="2019-9-25 11:30">
  12. <view class="describe-container" slot="describe">
  13. 广大群众反映步骤条问题
  14. </view>
  15. </l-step>
  16. <l-step title="2019-10-05 12:30">
  17. <view class="describe-container" slot="describe">
  18. 拾玖重构步骤条
  19. </view>
  20. </l-step>
  21. <l-step title="2019-10-25 13:30">
  22. <view class="describe-container" slot="describe">
  23. 步骤条更新完成😄
  24. </view>
  25. </l-step>
  26. </l-steps>

步骤条属性(Steps Attributes)

参数说明类型可选值默认值版本
direction步骤条方向Stringcolumn/rowrow0.6.8
active-index初始步骤条进度Number—-00.6.8
dot点状步骤条Boolean—-false0.6.8
status当前激活步骤条元素状态Stringprocess/errorprocess0.6.8
color步骤条激活状态颜色String—-—-0.6.8
reverse步骤条倒序排列Boolean—-true0.6.8
step-mini-height步骤条元素高度String—-1200.6.8

步骤条元素属性 (Step Attributes)

参数说明类型可选值默认值版本
title步骤条标题String———-0.6.8
describe步骤条描述String———-0.6.8
icon步骤条图标String———-0.6.8
icon-color步骤条图标颜色String———-0.6.8
icon-size步骤条图标大小String———-0.6.8
custom是否自定义步骤条元素Boolean—-false0.6.8

步骤条元素外部样式类 (Steps Class)

参数说明版本
l-class覆盖步骤条的外部样式类0.6.8

步骤条元素外部样式类 (Step Class)

参数说明版本
l-class覆盖步骤条元素的外部样式类
l-step-class覆盖步骤条元素数字部分的外部样式类0.6.8
l-describe-class覆盖步骤条元素描述内容的外部样式类0.6.8
l-title-class覆盖步骤条元素标题的外部样式类0.6.8
l-line-class覆盖步骤条元素线的外部样式类0.6.8

步骤条元素插槽(Step Solt)

插槽名称说明备注版本
dot自定义步骤条元素内容需同时设置custom属性0.6.8
describe自定义描述内容—-0.6.8