Subsection 分段器 | uView Next - 全面兼容 nvue 的 uni-app 生态框架

# Subsection 分段器

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

# 平台差异说明

App（vue）	App（nvue）	H5	小程序
√	√	√	√

# 基本使用

通过list数组参数传递分段的选项，数组元素可为字符串，或者通过keyName参数传入对象(默认为name)
通过current指定初始化时激活的选项

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

<script>
	export default {
		data() {
			return {
                list: ['未付款', '待评价', '已付款'],
				// 或者如下，也可以配置keyName参数修改对象键名
				// list: [{name: '未付款'}, {name: '待评价'}, {name: '已付款'}],
				current: 1
			}
		}
	}
</script>
✅ Copy success!

# 模式选择

通过mode设置分段器的模式

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

<u-subsection :list="list" mode="subsection" :current="1"></u-subsection>
✅ Copy success!

# 颜色配置

通过activeColor配置激活选项的文字颜色
通过inactiveColor配置未激活选项的文字颜色
通过bgColor配置背景颜色，mode为button时有效（默认 '#eeeeef' ）
通过list数组中的对象设置单个选项的文字颜色 3.4.8

<template>
	<view>
		<!-- 全局颜色配置 -->
		<u-subsection :list="list" :current="0" activeColor="#f56c6c"></u-subsection>
		
		<!-- 单个选项颜色配置 -->
		<u-subsection :list="customList" :current="0"></u-subsection>
	</view>
</template>

<script>
	export default {
		data() {
			return {
				list: ['未付款', '待评价', '已付款'],
				customList: [
					{name: '未付款', activeColor: '#f56c6c', inactiveColor: '#909399'},
					{name: '待评价', activeColor: '#e6a23c', inactiveColor: '#909399'},
					{name: '已付款'}
				]
			}
		}
	}
</script>
✅ Copy success!

# 禁用状态 3.4.8

通过disabled属性可以禁用整个分段器，也可以通过list数组中的对象设置单个选项的禁用状态。

<template>
	<view>
		<!-- 禁用整个分段器 -->
		<u-subsection :list="list" :current="0" :disabled="true"></u-subsection>
		
		<!-- 禁用单个选项 -->
		<u-subsection :list="disabledList" :current="0"></u-subsection>
	</view>
</template>

<script>
	export default {
		data() {
			return {
				list: ['未付款', '待评价', '已付款'],
				disabledList: [
					{name: '未付款'},
					{name: '待评价', disabled: true},
					{name: '已付款'}
				]
			}
		}
	}
</script>
✅ Copy success!

# 注意事项

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

<script>
	export default {
		data() {
			return {
                list: ['未付款', '待评价', '已付款'],
				curNow: 0
			}
		},
		methods: {
			sectionChange(index, item) {
				this.curNow = index;
				console.log(item)
			}
		}
	}
</script>
✅ Copy success!

# 此页面源代码地址

页面源码地址

github

gitee

# API

# Props

参数	说明	类型	默认值	可选值
list	选项的数组，形式见上方"基本使用"	Array	-	-
shape	外观形状	String \| Number	square	square \| circle
height	组件高度	String \| Number	30px	-
current	初始化时默认选中的选项索引值	String \| Number	0	-
activeColor	激活时的颜色	String	#3c9cff	-
inactiveColor	未激活时的颜色	String	#303133	-
mode	模式选择，见上方"模式选择"说明	String	button	subsection
fontSize	字体大小，单位px	String \| Number	12	-
bold	激活选项的字体是否加粗	Boolean	true	false
bgColor	组件背景颜色，`mode`为`button`时有效	String	#eeeeef	-
barColor	滑块背景色	String	-	-
disabled 3.4.8	是否禁用	Boolean	false	true
disabledBgColor 3.4.8	禁用时的背景颜色	String	#e5e5e5	-
disabledColor 3.4.8	禁用时的文字颜色	String	-	-
keyName	从`list`元素对象中读取的键名	String	name	-

# Events

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

← Section 查看更多 IndexList 索引列表 →