Steps 步骤条
Steps 步骤条,显示一个任务的进度或者引导用户完成某个复杂任务。
# 支持平台
| App(vue) | App(nvue) | H5 | 小程序 |
|---|---|---|---|
| ✓ | ✓ | ✓ | ✓ |
# 基础使用
通过 items 属性设置步骤条数据,current 属性指定当前步骤,从 0 开始记数。
<wui-steps :items="items" :current="current"></wui-steps>
const items = ref<any>([
{
title: '上传资料',
},
{
title: '医生评估',
},
{
title: '麻醉评估',
},
{
title: '护理评估',
},
{
title: '手术通知',
},
{
title: '术后康复',
},
]);
# 数字节点
通过 items 属性设置步骤条数据,current 属性指定当前步骤,从 0 开始记数,activeColor 属性设置已完成的步骤颜色。
<wui-steps :items="items" :current="current" activeColor="#FF2B2B"></wui-steps>
const items = ref<any>([
{
title: '注册',
text: '1',
},
{
title: '激活邮箱',
text: '2',
},
{
title: '注册完成',
text: '3',
},
]);
# 纵向展示
通过 items 属性设置步骤条数据,current 属性指定当前步骤,从 0 开始记数,direction 属性设置展示方向,padding 属性设置步骤条外层内边距。
<wui-steps :items="items" :current="current" direction="column" :padding="['0','32rpx']"></wui-steps>
const items = ref<any>([
{
title: '注册',
text: '1',
},
{
title: '激活邮箱',
text: '2',
},
{
title: '注册完成',
text: '3',
},
]);
//items 数据格式说明
//以下为约定属性,其他属性可自行增加
options: [{
//标题
title:'步骤一',
//描述信息,可选
descr:'步骤一描述',
//节点文本,可选
text: '',
//节点自定义图标src值,可选(text为空时有效)
src: '',
//步骤完成后自定义图标src值,可选(text为空且isMark为false时有效)
activeSrc:''
}]
# Slots
| 插槽名称 | 说明 |
|---|---|
| - | - |
# Props
| 属性名 | 类型 | 说明 | 默认值 | 平台差异说明 |
|---|---|---|---|---|
| items | Array | 步骤条数据,详细参数见下方说明 | [ ] | - |
| current | Number, String | 指定当前步骤,从 0 开始记数。 | 0 | - |
| direction | String | 步骤条展示方向,可选值:row(横向)/column(纵向)。 | row | - |
| padding | Array | 步骤条外层内边距,[上,右,下,左],可简写为[上,右] | [ ] | - |
| background | String | 步骤条外层背景色 | transparent | - |
| height | Number, String | 步骤条节点外层高度,当direction=column时为节点外层宽度,单位rpx | 50 | - |
| nodeColor | String | 节点颜色 | #ccc | - |
| color | String | 标题字体颜色 | #181818 | - |
| size | Number, String | 标题字体大小,单位rpx | 32 | - |
| fontWeight | Number, String | 标题字体字重 | 400 | - |
| descrColor | String | 描述信息字体颜色 | #B2B2B2 | - |
| descrSize | Number, String | 描述信息字体大小,单位rpx | 24 | - |
| activeColor | String | 已完成步骤高亮颜色 | #465CFF | 非Nvue端默认为空,可使用css变量(--wui-color-primary)来修改颜色值 |
| radius | String | 当节点使用自定义图标时,图标圆角值 | 0rpx | - |
| isMark | Boolean | 当前步骤是否需要对号标识 | true | - |
| isWait | Boolean | 是否为进行中,连接下一步骤线条一半高亮,仅direction=row时有效 | false | - |
# Events
| 事件名 | 说明 | 回调参数 |
|---|---|---|
| @click | 点击步骤内容时触发 | { index:当前步骤索引, ...this.items[index] } |