Steps 步骤条
介绍
用于展示操作流程的各个环节,让用户了解当前的操作在整体流程中的位置。
代码演示
基础用法
active 属性表示当前步骤的索引,从 0 起计。
<z-steps :active="active">
<z-step>第一步</z-step>
<z-step>第二步</z-step>
<z-step>第三步</z-step>
<z-step>第四步</z-step>
</z-steps>
import { ref } from 'vue';
const active = ref(1);
自定义样式
可以通过 active-icon 和 active-color 属性设置激活状态下的图标和颜色。
<z-steps :active="active" active-icon="check" inactive-icon="right-big" active-color="#07c160">
<z-step>第一步</z-step>
<z-step>第二步</z-step>
<z-step>第三步</z-step>
<z-step>第四步</z-step>
</z-steps>
竖向步骤条
可以通过设置 direction 属性来改变步骤条的显示方向。
<z-steps :active="0" direction="vertical">
<z-step>
<view>状态一</view>
<view>2016-07-12 12:40</view>
</z-step>
<z-step>
<view>状态二</view>
<view>2016-07-11 10:00</view>
</z-step>
<z-step>
<view>状态三</view>
<view>2016-07-10 09:30</view>
</z-step>
</z-steps>
API
Steps Props
| 参数 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| active | 当前步骤对应的索引值 | number | string | 0 |
| direction | 步骤条方向,可选值为 vertical | string | horizontal |
| active-icon | 当前步骤对应的底部图标,可选值见 Icon 组件 | string | checked |
| inactive-icon | 非当前步骤对应的底部图标,可选值见 Icon 组件 | string | - |
| finish-icon | 已完成步骤对应的底部图标,优先级高于 inactive-icon,可选值见 Icon 组件 | string | - |
| active-color | 当前步骤和已完成步骤的颜色 | string | #07c160 |
| inactive-color | 未激活步骤的颜色 | string | #969799 |
| icon-prefix | 图标类名前缀,等同于 Icon 组件的 class-prefix 属性 | string | z-icon |
Step Slots
| 名称 | 说明 |
|---|---|
| default | 步骤内容 |
| active-icon | 自定义激活状态图标 |
| inactive-icon | 自定义未激活状态图标 |
| finish-icon | 自定义已完成步骤对应的底部图标,优先级高于 inactive-icon |
Steps Events
| 事件名 | 说明 | 回调参数 |
|---|---|---|
| click-step | 点击步骤的标题或图标时触发 | index: number |
主题定制
样式变量
组件提供了下列 CSS 变量,可用于自定义样式,使用方法请参考 ConfigProvider 组件。
| 名称 | 默认值 | 描述 |
|---|---|---|
| --z-step-text-color | var(--z-text-color-2) | - |
| --z-step-active-color | var(--z-primary-color) | - |
| --z-step-process-text-color | var(--z-text-color) | - |
| --z-step-font-size | var(--z-font-size-md) | - |
| --z-step-line-color | var(--z-border-color) | - |
| --z-step-finish-line-color | var(--z-primary-color) | - |
| --z-step-finish-text-color | var(--z-text-color) | - |
| --z-step-icon-size | 24rpx | - |
| --z-step-circle-size | 10rpx | - |
| --z-step-circle-color | var(--z-gray-6) | - |
| --z-step-horizontal-title-font-size | var(--z-font-size-sm) | - |
| --z-steps-background | var(--z-background-2) | - |
