Steps 步骤条

优质
小牛编辑
125浏览
2023-12-01

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

基础用法

简单的步骤条。

<!--[active] 的值标识当前的进度 它是一个整数-->
<div class="demo">
  <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>
</div>
<el-button (click)="handle()">next</el-button>

含状态步骤条

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

<el-steps space="150px" [active]="1" [finish-status]="'success'">
  <el-step title="已完成"></el-step>
  <el-step title="进行中"></el-step>
  <el-step title="步骤 3"></el-step>
</el-steps>

有描述的步骤条

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

<el-steps  [active]="1" [align-center]="true">
  <el-step title="步骤 1" description="这是一段很长很长很长的描述性文字"></el-step>
  <el-step title="步骤 2" description="这是一段很长很长很长的描述性文字"></el-step>
  <el-step title="步骤 3" description="这是一段很长很长很长的描述性文字"></el-step>
</el-steps>

带图标的步骤条

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

通过 icon 属性来设置图标,图标的类型可以参考 Icon 组件的文档

<el-steps [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>

竖式步骤条

竖直方向的步骤条。

<el-steps space="120px" [active]="1" direction="vertical" [finish-status]="'success'">
  <el-step title="步骤 1"></el-step>
  <el-step title="步骤 2"></el-step>
  <el-step title="步骤 3"></el-step>
</el-steps>

简洁风格的步骤条

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

<el-steps [active]="1" [simple]="true">
  <el-step title="步骤 1"></el-step>
  <el-step title="步骤 2"></el-step>
  <el-step title="步骤 3"></el-step>
</el-steps>

Step Attributes

参数说明类型可选值默认值
title标题string
description描述性文字string
icon图标stringElement Icon 提供的图标

Steps Attributes

参数说明类型可选值默认值
space | | Number,String每个 step 的间距,不填写将自适应间距。支持百分比。如: 100px/50%string
direction显示方向stringvertical/horizontalhorizontal
active设置当前激活步骤,默认激活第一个是 1number0
process-status设置当前步骤的状态stringwait/process/finish/error/successprocess
finish-status设置结束步骤的状态stringwait/process/finish/error/successfinish
align-center标题描述居中对齐boolean
simple开启简洁风格boolean
center组件居中显示boolean