插件说明
这是 v-tabs
插件的升级版本,参数上有很大变动,支持 H5
小程序
手机端
,如果是在之前的插件上升级的话,请注意参数的变更,触发的事件没有变更。
使用说明
贴上地址:
- 插件地址: https://ext.dcloud.net.cn/plugin?id=1971
- Github 地址: https://github.com/xfjpeter/uni-plugins
1、最基本用法
1
| <v-tabs v-model="current" :tabs="tabs" @change="changeTab"></v-tabs>
|
1 2 3 4 5 6 7 8 9 10 11 12 13
| export default { data() { return { current: 0, tabs: ['军事', '国内', '新闻新闻', '军事', '国内', '新闻', '军事', '国内', '新闻'] } }, methods: { changeTab(index) { console.log('当前选中的项:' + index) } } }
|
2、平铺整个屏幕
1
| <v-tabs v-model="activeTab" :scroll="false" :tabs="['全部', '进行中', '已完成']"></v-tabs>
|
1 2 3 4 5 6 7
| export default { data() { return { activeTab: 0 } } }
|
3、胶囊用法
1
| <v-tabs v-model="current" :tabs="tabs" :pills="true" line-height="0" activeColor="#fff" @change="changeTab"></v-tabs>
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21
| 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-21
- 修复添加
fixed
属性后,滚动条无效
- 修复选项很少的情况下,下划线计算计算错误
- 新增
paddingItem
属性,设置选项左右边距(上下边距需要设置 height
属性,或者设置 padding
属性)
写在最后:
欢迎各位老铁反馈 bug ,本人后端 PHP 一枚,只是应为感兴趣前端,自己琢磨,自己搞。如果你在使用的过程中有什么不合理,需要优化的,都可以在下面评论(或加我 QQ: 1207791534),本人看见后回复、修正,感谢。
2020-09-17
- 紧急修复 bug,横向滑动不了的情况
2020-09-16
- 新增
fixed
属性,是否固定在顶部,示例地址:pages/tabs/tabs-static
- 优化之前的页面结构
注意:
- 使用
padding
属性的时候,尽量不要左右边距,会导致下划线位置不对
- 如果不绑定
v-model
会导致 change
事件改变的时候,下划线不跟随问题
2020-09-09
- 修复
width
错误,dom 加载的时候没有及时获取到 data
属性导致的。
2020-08-29
- 优化异步改变
tabs
后,下划线不初始化问题
github
地址上有图 2 的源码,需要的自行下载,页面路径:pages/tabs/order
2020-08-20
- 优化
节点查询
和 选中渲染
- 优化支付宝中
createSelectorQuery()
的影响
2020-08-19
- 优化
change
事件触发机制
2020-08-16
- 修改默认高度为
70rpx
- 新增属性
bgColor
,可设置背景颜色,默认 #fff
- 新增整个
tab
的 padding
属性,默认 0
2020-08-13
- 全新的
v-tabs 2.0
- 支持
H5
小程序
APP
- 属性高度可配置
预览


评论加载中