# Steps 步骤条
用于展示操作流程的各个环节,让用户了解当前的操作在整体流程中的位置。
# 引入
import PressSteps from 'press-ui/press-steps/press-steps';
export default {
components: {
PressSteps,
}
}
# 代码演示
# 基础用法
<press-steps :steps="steps" :active="active" />
export default {
data() {
return {
steps: [
{
text: '步骤一',
desc: '描述信息',
},
{
text: '步骤二',
desc: '描述信息',
},
{
text: '步骤三',
desc: '描述信息',
},
{
text: '步骤四',
desc: '描述信息',
},
],
active: 1,
}
},
};
# 自定义样式
可以通过 active-icon
和 active-color
属性设置激活状态下的图标和颜色。
<press-steps
:steps="steps"
:active="active"
active-icon="success"
active-color="#38f"
/>
# 自定义图标
可以通过 inactiveIcon
和 activeIcon
属性分别设置每一项的图标。
<press-steps :steps="steps" :active="active" />
Page({
data: {
steps: [
{
text: '步骤一',
desc: '描述信息',
inactiveIcon: 'location-o',
activeIcon: 'success',
},
{
text: '步骤二',
desc: '描述信息',
inactiveIcon: 'like-o',
activeIcon: 'plus',
},
{
text: '步骤三',
desc: '描述信息',
inactiveIcon: 'star-o',
activeIcon: 'cross',
},
{
text: '步骤四',
desc: '描述信息',
inactiveIcon: 'phone-o',
activeIcon: 'fail',
},
],
},
});
# 竖向步骤条
可以通过设置direction
属性来改变步骤条的显示方式。
<press-steps
:steps="steps"
:active="active"
direction="vertical"
active-color="#ee0a24"
/>
# API
# Steps Props
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
active | 当前步骤 | number | 0 |
steps | 步骤配置集合,见下面配置项 | Step 配置项数组 | [] |
direction | 显示方向,可选值为 horizontal vertical | string | horizontal |
active-color | 激活状态颜色 | string | #07c160 |
inactive-color | 未激活状态颜色 | string | #969799 |
active-icon | 激活状态底部图标,可选值见 Icon 组件 | string | checked |
inactive-icon | 未激活状态底部图标,可选值见 Icon 组件 | string | - |
# Events
事件名称 | 说明 | 回调参数 |
---|---|---|
click-step | 点击步骤时触发的事件 | event.detail:当前步骤的索引 |
# Step 配置项
键名 | 说明 | 类型 |
---|---|---|
text | 当前步骤名称 | string |
desc | 当前步骤描述信息 | string |
activeIcon | 当前步骤激活状态底部图标 | string |
inactiveIcon | 当前步骤未激活状态底部图标,可选值见 Icon 组件 | string |