Steps 步骤条
优质
小牛编辑
129浏览
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 | 图标 | string | Element Icon 提供的图标 |
Steps Attributes
参数 | 说明 | 类型 | 可选值 | 默认值 |
---|---|---|---|---|
space | | Number,String | 每个 step 的间距,不填写将自适应间距。支持百分比。如: 100px/50% | string | ||
direction | 显示方向 | string | vertical/horizontal | horizontal |
active | 设置当前激活步骤,默认激活第一个是 1 | number | 0 | |
process-status | 设置当前步骤的状态 | string | wait/process/finish/error/success | process |
finish-status | 设置结束步骤的状态 | string | wait/process/finish/error/success | finish |
align-center | 标题描述居中对齐 | boolean | ||
simple | 开启简洁风格 | boolean | ||
center | 组件居中显示 | boolean |