codecamp

ElementPlus Steps 步骤条

Steps 步骤条

引导用户按照流程完成任务的分步导航条,可根据实际应用场景设定步骤,步骤不得少于 2 步。

基础用法

简单的步骤条。


设置active属性,接受一个Number,表明步骤的 index,从 0 开始。需要定宽的步骤条时,设置space属性即可,它接受Number,单位为px,如果不设置,则为自适应。设置finish-status属性可以改变已经完成的步骤的状态。

<template>
  <el-steps :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>
</template>

<script>
  export default {
    data() {
      return {
        active: 0,
      }
    },

    methods: {
      next() {
        if (this.active++ > 2) this.active = 0
      },
    },
  }
</script>

含状态步骤条

每一步骤显示出该步骤的状态。


也可以使用title具名分发,可以用slot的方式来取代属性的设置,在本文档最后的列表中有所有的 slot name 可供参考。

<template>
  <el-steps :space="200" :active="1" finish-status="success">
  <el-step title="已完成"></el-step>
  <el-step title="进行中"></el-step>
  <el-step title="步骤 3"></el-step>
</el-steps>
</template>

有描述的步骤条

每个步骤有其对应的步骤状态描述。


<template>
  <el-steps :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>
</template>

居中的步骤条

标题和描述都将居中。


<template>
  <el-steps :active="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>
</el-steps>
</template>

带图标的步骤条

步骤条内可以启用各种自定义的图标。


通过icon属性来设置图标,图标的类型可以参考 Icon 组件的文档,除此以外,还能通过具名slot来使用自定义的图标。

<template>
  <el-steps :active="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>
</template>

竖式步骤条

竖直方向的步骤条。


只需要在el-steps元素中设置direction属性为vertical即可。

<template>
  <div style="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>
</div>
</template>

简洁风格的步骤条

设置 simple 可应用简洁风格,该条件下 align-center / description / direction / space 都将失效。


<template>
  <el-steps :active="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>

<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>
</template>

Steps Attributes

参数说明类型可选值默认值
space每个 step 的间距,不填写将自适应间距。支持百分比。number / string
direction显示方向stringvertical/horizontalhorizontal
active设置当前激活步骤number0
process-status设置当前步骤的状态stringwait / process / finish / error / successprocess
finish-status设置结束步骤的状态stringwait / process / finish / error / successfinish
align-center进行居中对齐boolean-false
simple是否应用简洁风格boolean-false

Step Attributes

参数说明类型可选值默认值
title标题string
description描述性文字string
icon图标传入 icon 的 class 全名来自定义 icon,也支持 slot 方式写入string
status设置当前步骤的状态,不设置则根据 steps 确定状态wait / process / finish / error / success-

Step Slot

name说明
icon自定义图标
title自定义标题
description自定义描述性文字


ElementPlus Dropdown 下拉菜单
ElementPlus Dialog 对话框
温馨提示
下载编程狮App,免费阅读超1000+编程语言教程
取消
确定
目录

ElementPlus 配置

关闭

MIP.setData({ 'pageTheme' : getCookie('pageTheme') || {'day':true, 'night':false}, 'pageFontSize' : getCookie('pageFontSize') || 20 }); MIP.watch('pageTheme', function(newValue){ setCookie('pageTheme', JSON.stringify(newValue)) }); MIP.watch('pageFontSize', function(newValue){ setCookie('pageFontSize', newValue) }); function setCookie(name, value){ var days = 1; var exp = new Date(); exp.setTime(exp.getTime() + days*24*60*60*1000); document.cookie = name + '=' + value + ';expires=' + exp.toUTCString(); } function getCookie(name){ var reg = new RegExp('(^| )' + name + '=([^;]*)(;|$)'); return document.cookie.match(reg) ? JSON.parse(document.cookie.match(reg)[2]) : null; }