tm-teps 步骤条

注意

1.1.4版本后(含),不兼容旧版本的颜色属性。新版本进行了重构,变得和其它组件统一,更为美观和精致。

🎉目录导航

👉使用方法,跟数1,2,3一样简单


基本示例

<tm-steps model="icon" v-model="active1" :list="list2" rangeKey="text"></tm-steps>
1
<script>
	export default {
		data() {
			return {
				active1:0,
				list2:[
					{text:'步骤1'},
					{text:'步骤2'},
					{text:'步骤3'},
				],
			}
		},
		methods: {}
	}
</script>

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

也可以使用字符串数组

<tm-steps model="number" v-model="active1" :list="list2"></tm-steps>
1
<script>
	export default {
		data() {
			return {
				active1:0,
				list2:['提交资料','审核资料','复核','成功提交'],
			}
		},
		methods: {}
	}
</script>

1
2
3
4
5
6
7
8
9
10
11
12

👉完整的示例


可以复制到页面直接运行

<template>
	<tm-fullView>
		<template v-slot:default="{info}">
			<view class="grey text " :class="tmVuetify.black?'black bk':''" :style="{minHeight:info.height+'px'}">
				<tm-menubars title="步骤条" color="bg-gradient-blue-accent" :showback="true"></tm-menubars>
				<tm-sheet :shadow="24">
					<view class="pa-12 text-size-s text-weight-b blue text mb-32 round-2" :class="tmVuetify.black?'black bk':''">基础示例</view>
					<tm-steps model="number" color="bg-gradient-blue-accent" activeFontColor="blue" line-color="bg-gradient-blue-accent" v-model="active" :list="list"></tm-steps>
					<view class="pa-12 text-size-s text-weight-b blue text mb-32 round-2" :class="tmVuetify.black?'black bk':''">通过插槽改变不同步骤的图标</view>
					<tm-steps model="icon" color="bg-gradient-pink-accent" active-icon="icon-angle-right" icon="icon-sync-alt" activeFontColor="pink" line-color="bg-gradient-pink-accent" v-model="active" :list="list">
						<template v-slot:icon="{data}">
							<block v-if="data.active&&data.index==2">
								<tm-icons :size="22" name="icon-times" color="yellow"></tm-icons>
							</block>
							<block v-if="!data.active">
								<tm-icons :size="22" :name="data.icon" color="grey"></tm-icons>
							</block>
							<block v-if="data.active&&data.index!=2">
								<tm-icons :size="22" :name="data.activeIcon" color="white"></tm-icons>
							</block>
						</template>
						
					</tm-steps>
					<tm-button theme="bg-gradient-blue-accent"    @click="active+=1">下一步</tm-button>
					<tm-button theme="grey-lighten-4"  font-color="blue" :shadow="0" @click="active-=1">上一步</tm-button>
				</tm-sheet>
				<tm-sheet :shadow="24">
					<view class="pa-12 text-size-s text-weight-b blue text mb-32 round-2" :class="tmVuetify.black?'black bk':''">点击步骤条</view>
					<tm-steps @click="iclick" model="icon" v-model="active1" :list="list2" rangeKey="text"></tm-steps>
					
				</tm-sheet>
			
				<view style="height: 50upx;"></view>
			</view>
		</template>
	</tm-fullView>

</template>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
<script>
	export default {
		data() {
			return {
				active:2,
				active1:0,
				list:['提交资料','审核资料','复核','成功提交'],
				list2:[
					{text:'步骤1'},
					{text:'步骤2'},
					{text:'步骤3'},
				],
			}
		},
		methods: {
			iclick(e){
				uni.$tm.toast(`你点击了${e}`)
				this.active1 = e;
			}
		}
	}
</script>

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

👉props属性表

注意

版本1.1.4后已经被重构颜色值只能是主题色名称。

属性名称类型可选值默认值说明
value.syncNumber任意数字0当前激活的项。双向绑定使用value.sync或者v-model,步骤是从1开始。
blackBooleantrue/falsefalse暗黑模式
colorString任意主题名称primary主题颜色激活的背景色。
range-keyString-text数据为对象数组时,需要提供对应的文字key
sizeNumber-42节点大小。
line-stylecss的边线类型-solid标准的css边线类型,比如:实线solid,虚线dashed
line-widthNumber-1连线的厚度,单位rpx
line-in-icon图标名称-''如果填写了图标名称,则在节点连间内的中间显示图标。
line-colorString任意主题名称primary激活时的线条颜色值
font-colorString任意主题名称grey默认未激活时的文字主题色
active-iconString图标名称icon-check激活后的图标
iconString图标名称icon-clock-fill未激活的图标
active-font-colorString颜任意主题名称primary默认激活时的文字主题色
modelStringnumber/iconnumber两种模式,number:数字,icon:图标模式

👉事件

事件名称返回参数返参类型说明
@change当前步骤位置Number步骤变换时触发
@click步骤位置Number点击步骤节点时触发

👉slot插槽

使用方法见完整示例

插槽名称插槽参数插槽数据说明
icondata{icon:未激活图标,activeIcon:激活图标,index:当前索引1开始,active:当前是否激活}图标模式的插槽
numberdata{icon:未激活图标,activeIcon:激活图标,index:当前索引1开始,active:当前是否激活}数字模式的插槽
defaultdata项目数据底下文字的插槽

👉更新日志

2021年9月6日 此组件已被重构,已统一颜色属性为主题名称,不再支持颜色的16进制值。

2021年8月20日14:8:5 初始版本。

tmzdy 于 2022/12/7 编辑 报错? | 评论?