xiaochengxu/components/v-tabs/readme.md

插件说明

这是 v-tabs 插件的升级版本，参数上有很大变动，支持 H5 小程序 手机端，如果是在之前的插件上升级的话，请注意参数的变更，触发的事件没有变更。

使用说明

1、最基本用法

• 视图文件

<v-tabs v-model="current" :tabs="tabs" @change="changeTab"></v-tabs>

• 脚本文件

export default {
  data() {
    return {
      current: 0,
      tabs: ['军事', '国内', '新闻新闻', '军事', '国内', '新闻', '军事', '国内', '新闻']
    }
  },
  methods: {
    changeTab(index) {
      console.log('当前选中的项：' + index)
    }
  }
}

2、平铺整个屏幕

• 视图文件

<v-tabs v-model="activeTab" :scroll="false" :tabs="['全部', '进行中', '已完成']"></v-tabs>

• 脚本文件

export default {
  data() {
    return {
      activeTab: 0
    }
  }
}

3、胶囊用法

• 视图文件

<v-tabs v-model="current" :tabs="tabs" :pills="true" line-height="0" activeColor="#fff" @change="changeTab"></v-tabs>

• 脚本文件

data() {
  return {
    current: 2,
    tabs: [
        '军事',
        '国内',
        '新闻新闻',
        '军事',
        '国内',
        '新闻',
        '军事',
        '国内',
        '新闻',
      ],
  },
  methods: {
    changeTab(index) {
      console.log('当前选中索引：' + index)
    }
  }
}

文档说明

1、属性说明

参数	类型	默认值	说明
value	Number	0	必传(双向绑定的值)
color	String	'#333'	默认文字颜色
activeColor	String	'#2979ff'	选中文字的颜色
fontSize	String	'28rpx'	默认文字大小(rpx 或 px)
bold	Boolean	true	是否加粗选中项
scroll	Boolean	true	是否显示滚动条，平铺设置 false
height	String	'70rpx'	tab 高度(rpx 或 px)
lineHeight	String	'10rpx'	滑块高度(rpx 或 px)
lineColor	String	'#2979ff'	滑块的颜色
lineScale	Number	0.5	滑块宽度缩放值
lineRadius	String	'10rpx'	滑块圆角宽度(rpx 或 px)
pills	Boolean	false	是否开启胶囊
pillsColor	String	'#2979ff'	胶囊背景颜色(rpx 或 px)
pillsBorderRadius	String	'10rpx'	胶囊圆角宽度(rpx 或 px)
field	String	''	如果 tabs 子项是对象，输入需要展示的键名
bgColor	String	'#fff'	背景色，支持 linear-gradient 渐变
padding	String	'0'	整个 tab padding 属性
fixed	Boolean	false	是否固定在顶部
paddingItem	String	'0 22rpx'	选项的边距（设置上下不生效，需要设置高度）

2、事件说明

名称	参数	说明
change	index	改变选中项触发, index 选中项的下标

更新日志

2020-09-24

1. 修复 v-tabs 第一次可能出现第一个标签显示不完整的情况
2. 修改了 pages/tabs/order 示例文件

2020-09-21

1. 修复添加 fixed 属性后，滚动条无效
2. 修复选项很少的情况下，下划线计算计算错误
3. 新增 paddingItem 属性，设置选项左右边距（上下边距需要设置 height 属性，或者设置 padding 属性）

写在最后： 欢迎各位老铁反馈 bug ，本人后端 PHP 一枚，只是应为感兴趣前端，自己琢磨，自己搞。如果你在使用的过程中有什么不合理，需要优化的，都可以在下面评论（或加我 QQ: 1207791534），本人看见后回复、修正，感谢。

2020-09-17

1. 紧急修复 bug，横向滑动不了的情况

2020-09-16

1. 新增 fixed 属性，是否固定在顶部，示例地址：pages/tabs/tabs-static
2. 优化之前的页面结构

注意：

1. 使用 padding 属性的时候，尽量不要左右边距，会导致下划线位置不对
2. 如果不绑定 v-model 会导致 change 事件改变的时候，下划线不跟随问题

2020-09-09

1. 修复 width 错误，dom 加载的时候没有及时获取到 data 属性导致的。

2020-08-29

1. 优化异步改变 tabs 后，下划线不初始化问题
2. github 地址上有图 2 的源码，需要的自行下载，页面路径：pages/tabs/order

2020-08-20

1. 优化 节点查询 和 选中渲染
2. 优化支付宝中 createSelectorQuery() 的影响

2020-08-19

1. 优化 change 事件触发机制

2020-08-16

1. 修改默认高度为 70rpx
2. 新增属性 bgColor，可设置背景颜色，默认 #fff
3. 新增整个 tab 的 padding 属性，默认 0

2020-08-13

1. 全新的 v-tabs 2.0
2. 支持 H5 小程序 APP
3. 属性高度可配置

预览