Subsection 分段器

13:10

该分段器一般用于用户从几个选项中选择某一个的场景

平台差异说明

App	H5	微信小程序	支付宝小程序	百度小程序	头条小程序	QQ小程序
√	√	√	√	√	√	√

基本使用

• 通过list数组参数传递分段的选项
• 通过current指定初始化时激活的选项

<template>
	<u-subsection :list="list" :current="1"></u-subsection>
</template>

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

// 定义分段器选项接口
interface SubsectionItem {
	name: string
}

// 定义响应式数据
const list = ref<SubsectionItem[]>([
	{
		name: '待发货'
	}, 
	{
		name: '待付款'
	}, 
	{
		name: '待评价'
	}
])

// 定义当前选中索引
const current = ref<number>(1)
</script>

模式选择

通过mode设置分段器的模式

• 值为button时为按钮类型
• 值为subsection时为分段器形式

<u-subsection :list="list" :current="1"></u-subsection>

是否开启动画效果

animation(默认为true)设置为true的话，分段器的三种模式滑块移动时都会有动画效果

<u-subsection :animation="true"></u-subsection>

颜色配置

• 通过active-color配置激活选项的文字颜色，mode为subsection时无效，此时默认为白色：
• 通过bgColor配置背景颜色
• 通过buttonColor配置按钮颜色，mode为button时有效

<u-subsection active-color="#ff9900"></u-subsection>

注意事项

如果想通过一个变量绑定current值，需要在change事件回调中修改此值，否则可能会由于props的限制，前后两次设置current为相同的值， 而导致无法通过修改current值触发分段器的变化。

<template>
	<view>
		<u-subsection :list="list" :current="curNow" @change="sectionChange"></u-subsection>
	</view>
</template>

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

// 定义分段器选项接口
interface SubsectionItem {
	name: string
}

// 定义响应式数据
const list = ref<SubsectionItem[]>([
	{
		name: '待发货'
	}, 
	{
		name: '待付款'
	}, 
	{
		name: '待评价'
	}
])

const curNow = ref<number>(0)

// 定义分段器变化回调函数
const sectionChange = (index: number) => {
	curNow.value = index
}
</script>

API

Props

参数	说明	类型	默认值	可选值
list	选项的数组，形式见上方"基本使用"	Array	-	-
current	初始化时默认选中的选项索引值	String | Number	0	-
active-color	激活时的颜色	String	#303133	-
inactive-color	未激活时的颜色	String	#606266	-
mode	模式选择，见上方"模式选择"说明	String	button	subsection
font-size	字体大小，单位rpx	String | Number	28	-
height	组件高度，单位rpx	String | Number	70	-
animation	是否开启动画效果，见上方说明	Boolean	true	false
bold	激活选项的字体是否加粗	Boolean	true	false
bg-color	组件背景颜色，mode为button时有效	String	#eeeeef	-
button-color	按钮背景颜色，mode为button时有效	String	#ffffff	-

Events

事件名	说明	回调参数
change	分段器选项发生改变时触发	index：选项的index索引值，从0开始