mirror of
https://gitee.com/ElemeFE/element.git
synced 2024-12-05 21:58:49 +08:00
4.0 KiB
4.0 KiB
Steps 步骤条
引导用户按照流程完成任务的分步导航条,可根据实际应用场景设定步骤,步骤不得少于 2 步。
基础用法
简单的步骤条。
:::demo 设置active
属性,接受一个Number
,表明步骤的 index,从 0 开始。需要定宽的步骤条时,设置space
属性即可,它接受Boolean
,单位为px
,如果不设置,则为自适应。设置finish-status
属性可以改变已经完成的步骤的状态。
<el-steps :space="100" :active="active" finish-status="success">
<el-step title="步骤 1"></el-step>
<el-step title="步骤 2"></el-step>
<el-step title="步骤 3"></el-step>
</el-steps>
<el-button style="margin-top: 12px;" @click="next">下一步</el-button>
<script>
export default {
data() {
return {
active: 0
};
},
methods: {
next() {
if (this.active++ > 2) this.active = 0;
}
}
}
</script>
:::
含状态步骤条
每一步骤显示出该步骤的状态。
:::demo 也可以使用title
具名分发,可以用slot
的方式来取代属性的设置,在本文档最后的列表中有所有的 slot name 可供参考。
<el-steps :space="100" :active="1" finish-status="success">
<el-step title="已完成"></el-step>
<el-step title="进行中"></el-step>
<el-step title="步骤 3"></el-step>
</el-steps>
:::
有描述的步骤条
每个步骤有其对应的步骤状态描述。
:::demo
<el-steps :space="200" :active="1">
<el-step title="步骤 1" description="这是一段很长很长很长的描述性文字"></el-step>
<el-step title="步骤 2" description="这是一段很长很长很长的描述性文字"></el-step>
<el-step title="步骤 3" description="这是一段很长很长很长的描述性文字"></el-step>
</el-steps>
:::
带图标的步骤条
步骤条内可以启用各种自定义的图标。
:::demo 通过icon
属性来设置图标,图标的类型可以参考 Icon 组件的文档,除此以外,还能通过具名slot
来使用自定义的图标。
<el-steps :space="100" :active="1">
<el-step title="步骤 1" icon="edit"></el-step>
<el-step title="步骤 2" icon="upload"></el-step>
<el-step title="步骤 3" icon="picture"></el-step>
</el-steps>
:::
竖式步骤条
竖直方向的步骤条。
:::demo 只需要在el-steps
元素中设置direction
属性为vertical
即可。
<el-steps :space="100" direction="vertical" :active="1">
<el-step title="步骤 1"></el-step>
<el-step title="步骤 2"></el-step>
<el-step title="步骤 3"></el-step>
</el-steps>
:::
Steps Attributes
参数 | 说明 | 类型 | 可选值 | 默认值 |
---|---|---|---|---|
space | 每个 step 的间距,不填写将自适应间距。支持百分比。 | Number,String | — | — |
direction | 显示方向 | string | vertical/horizontal | horizontal |
active | 设置当前激活步骤 | number | — | 0 |
process-status | 设置当前步骤的状态 | string | wait/process/finish/error/success | process |
finish-status | 设置结束步骤的状态 | string | wait/process/finish/error/success | finish |
align-center | 标题描述居中对齐 | boolean | - | false |
center | 组件居中显示 | boolean | - | false |
Step Attributes
参数 | 说明 | 类型 | 可选值 | 默认值 |
---|---|---|---|---|
title | 标题 | string | — | — |
description | 描述性文字 | string | — | — |
icon | 图标 | Element Icon 提供的图标,如果要使用自定义图标可以通过 slot 方式写入 | string | — |
Step Slot
name | 说明 |
---|---|
icon | 图标 |
title | 标题 |
description | 描述性文字 |