Steps 步骤条

该组件一般用于完成一个任务要分几个步骤,标识目前处于第几步的场景。
平台差异说明
| APP | H5 | 微信小程序 | 支付宝小程序 | QQ小程序 | ··· |
|---|---|---|---|---|---|
| √ | √ | √ | √ | √ | 适配中 |
代码示例
部分功能示例,具体可参考示例程序以及文档API。
基础用法
- 通过
current属性标识目前处于第几步,从 0 开始 fu-steps要配合fu-steps-item组件使用
html
<template>
<fu-steps :current="current">
<fu-steps-item :title="item.name" :desc="item.desc" v-for="(item,index) in list" :key="index"></fu-steps-item>
</fu-steps>
</template>
<script setup>
import { ref, reactive } from 'vue';
// data数据
const current = ref(0)
const list = reactive([
{ name: '步骤一', desc: '15:25' },
{ name: '步骤二', desc: '15:25' },
{ name: '步骤三', desc: '15:25' },
{ name: '步骤四', desc: '15:25' }
]);
</script>自定义颜色
- 通过
activeColor属性设置步骤条激活状态颜色 - 通过
inactiveColor属性设置步骤条未激活状态颜色
html
<template>
<fu-steps :current="current" activeColor="#ffaa00" inactiveColor="#999999">
<fu-steps-item :title="item.name" :desc="item.desc" v-for="(item,index) in list" :key="index"></fu-steps-item>
</fu-steps>
</template>
<script setup>
import { ref, reactive } from 'vue';
// data数据
const current = ref(0)
const list = reactive([
{ name: '步骤一', desc: '15:25' },
{ name: '步骤二', desc: '15:25' },
{ name: '步骤三', desc: '15:25' },
{ name: '步骤四', desc: '15:25' }
]);
</script>设置竖向步骤条
- 通过
direction属性设置column步骤条方向为竖向
html
<template>
<fu-steps :current="current" direction="column">
<fu-steps-item :title="item.name" :desc="item.desc" v-for="(item,index) in list" :key="index"></fu-steps-item>
</fu-steps>
</template>
<script setup>
import { ref, reactive } from 'vue';
// data数据
const current = ref(0)
const list = reactive([
{ name: '步骤一', desc: '15:25' },
{ name: '步骤二', desc: '15:25' },
{ name: '步骤三', desc: '15:25' },
{ name: '步骤四', desc: '15:25' }
]);
</script>设置步骤条模式
- 通过
dot属性设置步骤条点模式,可选值为true和false
html
<template>
<fu-steps :current="current" dot>
<fu-steps-item :title="item.name" :desc="item.desc" v-for="(item,index) in list" :key="index"></fu-steps-item>
</fu-steps>
</template>
<script setup>
import { ref, reactive } from 'vue';
// data数据
const current = ref(0)
const list = reactive([
{ name: '步骤一', desc: '15:25' },
{ name: '步骤二', desc: '15:25' },
{ name: '步骤三', desc: '15:25' },
{ name: '步骤四', desc: '15:25' }
]);
</script>API
Steps Props
| 属性名 | 说明 | 类型 | 默认值 | 可选值 |
|---|---|---|---|---|
| direction | 排列方向 | String | row | column |
| current | 设置当前处于第几步 | String|Number | 0 | - |
| activeColor | 激活状态颜色 | String | #2979ff | - |
| inactiveColor | 未激活状态颜色 | String | #969799 | - |
| dot | 是否显示点模式 | Boolean | false | true |
Steps Slots
| 插槽名 | 说明 |
|---|---|
| default | 步骤条步骤 |
StepsItem Props
| 属性名 | 说明 | 类型 | 默认值 | 可选值 |
|---|---|---|---|---|
| title | 标题 | String | - | - |
| desc | 描述 | String | - | - |
| iconSize | 图标大小 | String|Number | 17 | - |
| error | 当前步骤是否处于失败状态 | Boolean | false | - |
StepsItem Slots
| 插槽名 | 说明 |
|---|---|
| icon | 自定义图标内容 |
| title | 自定义标题内容 |
| desc | 自定义描述内容 |