Tu-view

# Steps 步骤条

引导用户按照流程完成任务的分步导航条，可根据实际应用场景设定步骤，步骤不得少于 2 步。

# 基础用法

简单的步骤条。

上一步 下一步

设置active属性，接受一个Number，表明步骤的 index，从 0 开始。需要定宽的步骤条时，设置space属性即可，它接受Number，单位为px，如果不设置，则为自适应。设置finish-status属性可以改变已经完成的步骤的状态。

<template>
	<div class="steps-block">
		<tu-steps
			:active="active"
			finish-status="success"
		>
			<tu-step title="步骤 1"></tu-step>
			<tu-step title="步骤 2"></tu-step>
			<tu-step title="步骤 3"></tu-step>
		</tu-steps>

		<div class="btn-wrapper">
			<tu-button @click="previous">上一步</tu-button>
			<tu-button @click="next">下一步</tu-button>
		</div>
	</div>
</template>

<script>
	export default {
		data() {
			return {
				active: 0,
			};
		},

		methods: {
			next() {
				if (this.active++ > 2) this.active = 0;
			},
			previous() {
				if (this.active-- < 0) this.active = 0;
			},
		},
	};
</script>
<style>
	.steps-block .btn-wrapper {
		margin-top: 20px;
	}
	.steps-block .btn-wrapper .tu-button + .tu-button {
		margin-left: 4px;
	}
</style>
Expand Copy

# 含状态步骤条

每一步骤显示出该步骤的状态。

也可以使用title具名分发，可以用slot的方式来取代属性的设置，在本文档最后的列表中有所有的 slot name 可供参考。

<template>
	<tu-steps
		:space="200"
		:active="1"
		finish-status="success"
	>
		<tu-step title="已完成"></tu-step>
		<tu-step title="进行中"></tu-step>
		<tu-step title="步骤 3"></tu-step>
	</tu-steps>
</template>
Expand Copy

# 有描述的步骤条

每个步骤有其对应的步骤状态描述。

<template>
	<tu-steps :active="1">
		<tu-step
			title="步骤 1"
			description="这是一段很长很长很长的描述性文字"
		></tu-step>
		<tu-step
			title="步骤 2"
			description="这是一段很长很长很长的描述性文字"
		></tu-step>
		<tu-step
			title="步骤 3"
			description="这段就没那么长了"
		></tu-step>
	</tu-steps>
</template>
Expand Copy

# 居中的步骤条

标题和描述都将居中。

<template>
	<tu-steps
		:active="2"
		align-center
	>
		<tu-step
			title="步骤1"
			description="这是一段很长很长很长的描述性文字"
		></tu-step>
		<tu-step
			title="步骤2"
			description="这是一段很长很长很长的描述性文字"
		></tu-step>
		<tu-step
			title="步骤3"
			description="这是一段很长很长很长的描述性文字"
		></tu-step>
		<tu-step
			title="步骤4"
			description="这是一段很长很长很长的描述性文字"
		></tu-step>
	</tu-steps>
</template>
Expand Copy

# 带图标的步骤条

步骤条内可以启用各种自定义的图标。

通过icon属性来设置图标，图标的类型可以参考 Icon 组件的文档，除此以外，还能通过具名slot来使用自定义的图标。

<template>
	<tu-steps :active="1">
		<tu-step
			title="步骤 1"
			icon="tu-icon-frown"
		></tu-step>
		<tu-step
			title="步骤 2"
			icon="tu-icon-meh"
		></tu-step>
		<tu-step
			title="步骤 3"
			icon="tu-icon-smile"
		></tu-step>
	</tu-steps>
</template>
Expand Copy

# 竖式步骤条

竖直方向的步骤条。

只需要在tu-steps元素中设置direction属性为vertical即可。

<template>
	<div style="height: 300px;">
		<tu-steps
			direction="vertical"
			:active="1"
		>
			<tu-step title="步骤 1"></tu-step>
			<tu-step title="步骤 2"></tu-step>
			<tu-step
				title="步骤 3"
				description="这是一段很长很长很长的描述性文字"
			></tu-step>
		</tu-steps>
	</div>
</template>
Expand Copy

# 简洁风格的步骤条

设置 simple 可应用简洁风格，该条件下 align-center / description / direction / space 都将失效。

<template>
	<div>
		<tu-steps
			:active="1"
			simple
		>
			<tu-step
				title="步骤 1"
				icon="tu-icon-frown"
			></tu-step>
			<tu-step
				title="步骤 2"
				icon="tu-icon-meh"
			></tu-step>
			<tu-step
				title="步骤 3"
				icon="tu-icon-smile"
			></tu-step>
		</tu-steps>

		<tu-steps
			:active="1"
			finish-status="success"
			simple
			style="margin-top: 20px"
		>
			<tu-step title="步骤 1"></tu-step>
			<tu-step title="步骤 2"></tu-step>
			<tu-step title="步骤 3"></tu-step>
		</tu-steps>
	</div>
</template>
Expand Copy

# Steps Attributes

参数 说明 类型 可选值 默认值
space 每个 step 的间距，不填写将自适应间距。支持百分比。 number / string — —
direction 显示方向 string vertical/horizontal horizontal
active 设置当前激活步骤 number — 0
process-status 设置当前步骤的状态 string wait / process / finish / error / success process
finish-status 设置结束步骤的状态 string wait / process / finish / error / success finish
align-center 进行居中对齐 boolean - false
simple 是否应用简洁风格 boolean - false

# Step Attributes

参数 说明 类型 可选值 默认值
title 标题 string — —
description 描述性文字 string — —
icon 图标 传入 icon 的 class 全名来自定义 icon，也支持 slot 方式写入 string —
status 设置当前步骤的状态，不设置则根据 steps 确定状态 wait / process / finish / error / success -

# Step Slot

name 说明
icon 自定义图标
title 自定义标题
description 自定义描述性文字

← Alert 警告 →