当前位置:首页 > 前端教程

elementui steps

2026-03-05 21:01:28前端教程

ElementUI Steps 组件指南

ElementUI 的 Steps 组件用于展示任务流程或步骤进度,适用于向导、订单跟踪等场景。以下是关键用法和配置说明:

基础用法

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

active 属性控制当前激活步骤(从 0 开始计数),finish-status 设置完成状态样式(success/error/wait)。

自定义样式

通过 space 属性控制步骤间距(单位px):

<el-steps :space="200">
  <el-step title="步骤1" description="描述信息"></el-step>
</el-steps>

description 可添加步骤描述文本,icon 属性支持替换默认图标:

<el-step title="步骤1" icon="el-icon-edit"></el-step>

垂直方向

添加 direction 属性实现竖向步骤条:

elementui steps

<el-steps direction="vertical" :active="1">
  <el-step title="步骤1"></el-step>
  <el-step title="步骤2"></el-step>
</el-steps>

状态控制

单个步骤可通过 status 指定状态:

<el-step title="步骤1" status="error"></el-step>

可选状态值:wait(默认)、processfinisherrorsuccess

高级配置

align-center 属性使步骤居中对齐:

elementui steps

<el-steps :active="2" align-center>
  <el-step title="步骤1"></el-step>
</el-steps>

process-status 可自定义进行中状态的显示文本:

<el-steps :active="1" process-status="loading">
  <el-step title="步骤1"></el-step>
</el-steps>

事件绑定

Steps 组件支持 click 事件:

<el-steps @click="handleStepClick">
  <el-step title="步骤1"></el-step>
</el-steps>
methods: {
  handleStepClick(step) {
    console.log(step.index);
  }
}

响应式设计

结合 Vue 数据动态控制步骤状态:

data() {
  return {
    active: 0,
    steps: [
      { title: '注册', status: 'finish' },
      { title: '验证', status: 'process' }
    ]
  }
}

注意事项:

  1. 步骤索引从 0 开始计数
  2. 通过 CSS 可自定义步骤条颜色和图标大小
  3. 复杂场景建议结合 Vuex 管理步骤状态

标签: elementuisteps
分享给朋友:

相关文章

elementui router

elementui router

Element UI 结合 Vue Router 的使用方法 Element UI 是一个基于 Vue.js 的组件库,而 Vue Router 是 Vue.js 的官方路由管理器。将两者结合使用可以…

elementui按需

elementui按需

ElementUI 按需引入方法 ElementUI 支持按需引入组件,以减少最终打包体积。以下是具体实现方式: 安装 babel-plugin-component 需要安装官方推荐的 babel…

elementui  文档

elementui 文档

以下是 Element UI 官方文档及相关资源的整理: 官方文档地址 Element UI 的官方文档可通过以下链接访问: 中文文档:https://element.eleme.cn…

elementui treegrid

elementui treegrid

ElementUI TreeGrid 实现方法 ElementUI 本身并未直接提供 TreeGrid 组件,但可以通过组合 Tree 和 Table 组件或使用第三方扩展库实现类似功能。以下是几种实…

elementui日志

elementui日志

以下是关于 Element UI 日志相关的信息整理: Element UI 官方日志文档 Element UI 的更新日志(Changelog)通常可以在其 GitHub 仓库或官方文档中找到。通…

elementui open=

elementui open=

ElementUI Open 方法详解 ElementUI 是一个基于 Vue.js 的组件库,提供了丰富的 UI 组件。open 方法通常用于打开对话框、下拉菜单等交互组件。 Dialog 组件的…