Skip to content

Steps 步骤条

13:10

该组件一般用于完成一个任务要分几个步骤,标识目前处于第几步的场景。

平台差异说明

AppH5微信小程序支付宝小程序百度小程序头条小程序QQ小程序

基本使用

  • 通过list参数传入一个数组,标识步骤的总数
  • 通过current参数标识目前处于第几步,从0开始
html
<template>
	<view>
		<u-steps :list="numList" :current="1"></u-steps>
	</view>
</template>

<script setup lang="ts">
import { ref } from 'vue'

// 定义步骤项接口
interface StepItem {
	name: string
}

// 定义响应式数据
const numList = ref<StepItem[]>([
	{
		name: '下单'
	}, 
	{
		name: '出库'
	}, 
	{
		name: '运输'
	}, 
	{
		name: '签收'
	}
])
</script>

设置步骤条的主题

  • type值可选的有primary(默认)、successinfowarningerror
  • type值和active-color(默认为空)为互斥关系,如果设置了active-color,会优先起作用
html
<u-steps :list="numList" active-color="#fa3534"></u-steps>

设置步骤条的模式

mode可以设置为dot(圆点,默认值)或者number(数字),二者有不同形式,见示例

html
<u-steps :list="numList" mode="number"></u-steps>

API

Props

参数说明类型默认值可选值
mode设置模式Stringdotnumber
list数轴条数据,数组。具体见上方示例Array[ ]-
type(1.3.7起已废弃)type主题Stringprimaryinfo / success / error / warning
current设置当前处于第几步Number | String0-
directionrow-横向,column-竖向Stringrowcolumn
active-color已完成步骤的激活颜色,如设置,type值会失效String--
un-active-color未激活的颜色,用于表示未完成步骤的颜色String#606266-
iconmode = number时的自定义图标Stringcheckmark-