Steps 步骤条

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

基础用法

简单的步骤条。


显示代码

注意

$(el)innerHtml将被替换。

有描述的步骤条

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

显示代码

自定义步骤条

可自定义图标、宽度、状态。

显示代码

竖式步骤条

竖直方向的步骤条。

显示代码

简单风格的步骤条

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

显示代码

参数

你可以通过修改$.fn.steps.defaults来修改全局默认配置,也可以在初始化时传入指定配置$(#id).steps({xx: xx})。 参数默认为 Json ,若为数组,则会被当做data赋值。

参数 说明 类型 可选值 默认值
data 步骤参数数组,具体配置见下方【data参数】 array - []
space 每个 step 的间距,不填写将自适应间距。支持百分比。 number / string - -
direction 显示方向 string vertical/horizontal 'horizontal'
active 设置当前激活步骤 number - 1
processStatus 设置当前步骤的状态 string wait / process / finish / error / success 'process'
finishStatus 设置结束步骤的状态 string wait / process / finish / error / success 'finish'
alignCenter 进行居中对齐 boolean - false
simple 是否应用简洁风格 boolean - false

data参数

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

方法

你可以通过调用$(#id).steps('set', xxx)来更新已被初始化过的步骤条的状态。

方法 说明 举例
set 设置当前激活步骤,从1开始算 $(el).steps('set', 2)