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-iconactive-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 | string0
direction步骤条方向,可选值为 verticalstringhorizontal
active-icon当前步骤对应的底部图标,可选值见 Icon 组件stringchecked
inactive-icon非当前步骤对应的底部图标,可选值见 Icon 组件string-
finish-icon已完成步骤对应的底部图标,优先级高于 inactive-icon,可选值见 Icon 组件string-
active-color当前步骤和已完成步骤的颜色string#07c160
inactive-color未激活步骤的颜色string#969799
icon-prefix图标类名前缀,等同于 Icon 组件的 class-prefix 属性stringz-icon

Step Slots

名称说明
default步骤内容
active-icon自定义激活状态图标
inactive-icon自定义未激活状态图标
finish-icon自定义已完成步骤对应的底部图标,优先级高于 inactive-icon

Steps Events

事件名说明回调参数
click-step点击步骤的标题或图标时触发index: number

主题定制

样式变量

组件提供了下列 CSS 变量,可用于自定义样式,使用方法请参考 ConfigProvider 组件

名称默认值描述
--z-step-text-colorvar(--z-text-color-2)-
--z-step-active-colorvar(--z-primary-color)-
--z-step-process-text-colorvar(--z-text-color)-
--z-step-font-sizevar(--z-font-size-md)-
--z-step-line-colorvar(--z-border-color)-
--z-step-finish-line-colorvar(--z-primary-color)-
--z-step-finish-text-colorvar(--z-text-color)-
--z-step-icon-size24rpx-
--z-step-circle-size10rpx-
--z-step-circle-colorvar(--z-gray-6)-
--z-step-horizontal-title-font-sizevar(--z-font-size-sm)-
--z-steps-backgroundvar(--z-background-2)-