Subsection 分段器

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

平台差异说明

AppH5微信小程序支付宝小程序百度小程序头条小程序QQ小程序

基本使用

  • 通过list数组参数传递分段的选项
  • 通过current指定初始化时激活的选项
  1. <template>
  2. <u-subsection :list="list" :current="1"></u-subsection>
  3. </template>
  4. <script>
  5. export default {
  6. data() {
  7. return {
  8. list: [
  9. {
  10. name: '待发货'
  11. },
  12. {
  13. name: '待付款'
  14. },
  15. {
  16. name: '待评价'
  17. }
  18. ],
  19. current: 1
  20. }
  21. }
  22. }
  23. </script>

模式选择

通过mode设置分段器的模式

  • 值为button时为按钮类型
  • 值为subsection时为分段器形式
  1. <u-subsection :list="list" :current="1"></u-subsection>

是否开启动画效果

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

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

颜色配置

  • 通过active-color配置激活选项的文字颜色,modesubsection时无效,此时默认为白色:
  • 通过bgColor配置背景颜色
  • 通过buttonColor配置按钮颜色,modebutton时有效
  1. <u-subsection active-color="#ff9900"></u-subsection>

注意事项

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

  1. <template>
  2. <view>
  3. <u-subsection :list="list" :current="curNow" @change="sectionChange"></u-subsection>
  4. </view>
  5. </template>
  6. <script>
  7. export default {
  8. data() {
  9. return {
  10. list: [
  11. {
  12. name: '待发货'
  13. },
  14. {
  15. name: '待付款'
  16. },
  17. {
  18. name: '待评价'
  19. }
  20. ],
  21. curNow: 0
  22. }
  23. },
  24. mehtods: {
  25. sectionChange(index) {
  26. this.curNow = index;
  27. }
  28. }
  29. }
  30. </script>

API

Props

参数说明类型默认值可选值
list选项的数组,形式见上方”基本使用”Array--
current初始化时默认选中的选项索引值String | Number0-
active-color激活时的颜色,modesubsection时固定为白色String#ff9900-
inactive-color未激活时字体的颜色,modesubsection时无效String#303133true
mode模式选择,见上方”模式选择”说明Stringbuttonsubsection
font-size字体大小,单位rpxString | Number28-
animation是否开启动画效果,见上方说明Booleantruefalse
bold激活选项的字体是否加粗Booleantruefalse
bg-color组件背景颜色,modebutton时有效String#eeeeef-
button-color按钮背景颜色,modebutton时有效String#ffffff-

Events

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