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