该分段器一般用于用户从几个选项中选择某一个的场景
#平台差异说明
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
#模式选择
通过mode
设置分段器的模式
- 值为
button
时为按钮类型 - 值为
subsection
时为分段器形式
<u-subsection :list="list" mode="subsection" :current="1"></u-subsection>
copy
#颜色配置
- 通过
activeColor
配置激活选项的文字颜色 - 通过
inactiveColor
配置未激活选项的文字颜色 - 通过
bgColor
配置背景颜色,mode为button时有效(默认 '#eeeeef' )
<u-subsection activeColor="#f56c6c"></u-subsection>
copy
#注意事项
如果想通过一个变量绑定current
值,需要在change
事件回调中修改此值,否则可能会由于props
的限制,前后两次设置current
为相同的值, 而导致无法通过修改current
值触发分段器的变化。
<template> <u-subsection :list="list" :current="curNow" @change="sectionChange"></u-subsection> </template> <script> export default { data() { return { list: ['未付款', '待评价', '已付款'], curNow: 0 } }, methods: { sectionChange(index) { this.curNow = index; } } } </script>