Skip to content

ElSimpleSteps 步骤条

ElSimpleSteps 是一个轻量级步骤条组件,用于展示多步骤流程的当前步骤位置。步骤的展示状态(未开始/进行中/已完成)由 v-model 当前值推导,不修改 options 数据。对于更复杂的步骤条需求,建议使用 Element Plus 的 <el-steps> 组件。

基础用法

默认步骤条不占满宽度,仅通过 space 设置步骤项最小间距,可自行设置宽度占满可用空间。

步骤跳转

组件未提供【上一步】/【下一步】方法,需通过 v-model 或 ref 调用 setStep 实现跳转。

API

属性名描述类型默认值
v-model当前步骤(第几步)number1
space步骤项最小间距number16
options步骤配置EllSimpleStepsOption[][]

Exposes

名称说明类型
setStep设置当前步骤(step: number) => void

类型说明

主包导出:

ts
import type { EllSimpleStepsOption, EllSimpleStepsProps } from 'element-plus-lab'
  • EllSimpleStepsOption:单步 label / value(从 1 起的序号)
  • EllSimpleStepsProps:组件 props 形状,与上表 API 一致。
显示类型声明
ts
export interface EllSimpleStepsOption {
  label: string
  value: number
}

export interface EllSimpleStepsProps {
  options: EllSimpleStepsOption[]
  space?: number
}

贡献者

页面历史

Released under the Apache License 2.0.