3.2 KiB
3.2 KiB
| category | subtitle | type | cols | title | cover | coverDark |
|---|---|---|---|---|---|---|
| Components | 步骤条 | 导航 | 1 | Steps | https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*677sTqCpE3wAAAAAAAAAAAAADrJ8AQ/original | https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*cFsBQLA0b7UAAAAAAAAAAAAADrJ8AQ/original |
引导用户按照流程完成任务的导航条。
何时使用
当任务复杂或者存在先后关系时,将其分解成一系列步骤,从而简化任务。
API
Steps
整体步骤条。
| 参数 | 说明 | 类型 | 默认值 | 版本 |
|---|---|---|---|---|
| current (v-model) | 指定当前步骤,从 0 开始记数。在子 Step 元素中,可以通过 status 属性覆盖状态, 1.5.0 后支持 v-model |
number | 0 | |
| direction | 指定步骤条方向。目前支持水平(horizontal)和竖直(vertical)两种方向 |
string | horizontal | |
| initial | 起始序号,从 0 开始记数 | number | 0 | |
| labelPlacement | 指定标签放置位置,默认水平放图标右侧,可选vertical放图标下方 |
string | horizontal |
|
| percent | 当前 process 步骤显示的进度条进度(只对基本类型的 Steps 生效) |
number | - | 3.0 |
| progressDot | 点状步骤条,可以设置为一个 作用域插槽,labelPlacement 将强制为vertical |
Boolean or v-slot:progressDot="{index, status, title, description, prefixCls, iconDot}" | false | |
| responsive | 当屏幕宽度小于 532px 时自动变为垂直模式 | boolean | true | 3.0 |
| size | 指定大小,目前支持普通(default)和迷你(small) |
string | default | |
| status | 指定当前步骤的状态,可选 wait process finish error |
string | process | |
| type | 步骤条类型,有 default 和 navigation 两种 |
string | default |
1.5.0 |
| items | 配置选项卡内容 | StepItem[] | [] |
type="inline" (4.0+)
| 参数 | 说明 | 类型 | 默认值 | 版本 |
|---|---|---|---|---|
| current | 指定当前步骤,从 0 开始记数。在子 Step 元素中,可以通过 status 属性覆盖状态 |
number | 0 | |
| initial | 起始序号,从 0 开始记数 | number | 0 | |
| status | 指定当前步骤的状态,可选 wait process finish error |
string | process |
|
| items | 配置选项卡内容,不支持 icon subtitle |
StepItem | [] |
Steps 事件
| 事件名称 | 说明 | 回调参数 | 版本 | |
|---|---|---|---|---|
| change | 点击切换步骤时触发 | (current) => void | - | 1.5.0 |
Steps.Step
步骤条内的每一个步骤。
| 参数 | 说明 | 类型 | 默认值 | 版本 |
|---|---|---|---|---|
| description | 步骤的详情描述,可选 | string | slot | - | |
| disabled | 禁用点击 | boolean | false | 1.5.0 |
| icon | 步骤图标的类型,可选 | string | slot | - | |
| status | 指定状态。当不配置该属性时,会使用 Steps 的 current 来自动指定状态。可选:wait process finish error |
string | wait |
|
| subTitle | 子标题 | string | slot | - | 1.5.0 |
| title | 标题 | string | slot | - |