引导用户按照流程完成任务的分步导航条,可根据实际应用场景设定步骤,步骤不得少于 2 步。
设置active
属性,接受一个Number
,表明步骤的 index,从 0 开始。需要定宽的步骤条时,设置space
属性即可,它接受Number
,单位为px
,如果不设置,则为自适应。设置finish-status
属性可以改变已经完成的步骤的状态。
"active" finish-status="success"> - <el-step title="步骤 1">el-step>
- <el-step title="步骤 2">el-step>
- <el-step title="步骤 3">el-step>
-
- <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>
每一步骤显示出该步骤的状态。
- //也可以使用title具名分发,可以用slot的方式来取代属性的设置
-
"200" :active="1" finish-status="success"> - <el-step title="已完成">el-step>
- <el-step title="进行中">el-step>
- <el-step title="步骤 3">el-step>
每个步骤有其对应的步骤状态描述。
"1"> - <el-step title="步骤 1" description="这是一段很长很长很长的描述性文字">el-step>
- <el-step title="步骤 2" description="这是一段很长很长很长的描述性文字">el-step>
- <el-step title="步骤 3" description="这段就没那么长了">el-step>
标题和描述都将居中。
"2" align-center> - <el-step title="步骤1" description="这是一段很长很长很长的描述性文字">el-step>
- <el-step title="步骤2" description="这是一段很长很长很长的描述性文字">el-step>
- <el-step title="步骤3" description="这是一段很长很长很长的描述性文字">el-step>
- <el-step title="步骤4" description="这是一段很长很长很长的描述性文字">el-step>
步骤条内可以启用各种自定义的图标。
- //通过icon属性来设置图标,图标的类型可以参考 Icon 组件的文档,除此以外,还能通过具名slot来使用自定义的图标。
-
-
"1"> - <el-step title="步骤 1" icon="el-icon-edit">el-step>
- <el-step title="步骤 2" icon="el-icon-upload">el-step>
- <el-step title="步骤 3" icon="el-icon-picture">el-step>
竖直方向的步骤条。
只需要在el-steps
元素中设置direction
属性为vertical
即可。
- "height: 300px;">
- <el-steps direction="vertical" :active="1">
- <el-step title="步骤 1">el-step>
- <el-step title="步骤 2">el-step>
- <el-step title="步骤 3" description="这是一段很长很长很长的描述性文字">el-step>
- el-steps>
设置
simple
可应用简洁风格,该条件下align-center
/description
/direction
/space
都将失效。
"1" simple> - <el-step title="步骤 1" icon="el-icon-edit">el-step>
- <el-step title="步骤 2" icon="el-icon-upload">el-step>
- <el-step title="步骤 3" icon="el-icon-picture">el-step>
-
- <el-steps :active="1" finish-status="success" simple style="margin-top: 20px">
- <el-step title="步骤 1" >el-step>
- <el-step title="步骤 2" >el-step>
- <el-step title="步骤 3" >el-step>
- el-steps>