更新记录

1.0.0(2024-07-23) 下载此版本

发布


平台兼容性

Vue2 Vue3
×
App 快应用 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
× × × × × ×
钉钉小程序 快手小程序 飞书小程序 京东小程序
× × × ×
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari
× × × × × × × × ×

小程序自定义组件的通用使用方式详见:uni-app中使用小程序自定义组件教程


jack-beatabbar-wx简介

jack-beatabbar-wx是一款适用于uniapp的底部导航栏插件,其样式可定制,样式新颖灵动,打破了uniapp默认tabbar栏不可自定义的壁垒。此插件仅适用于uniapp开发微信小程序,如需h5版本请移步这里。开发使用的微信小程序的开发语言,因此理论上也可以直接用在微信小程序的原生开发中,组件的编写依靠微信官方文档

开发文档

1.首先打开下载好的uni_modules/jack-beattabbar-wx/wxcomponents目录,将custom-tab-bar文件夹整体复制到项目根目录。

2.在pages.json中配置页面信息,注意使用图片绝对路径,否则可能出现获取不到的情况,加上"custom":true,以关闭默认tabBar。

//示例:
{
    "pages": [ //pages数组中第一项表示应用启动页
        {
            "path": "pages/index/index",
            "style": {
                "navigationBarTitleText": "uni-app"
            }
        },
        {
            "path" : "pages/my/my",
            "style" : 
            {
                "navigationBarTitleText" : "我的"
            }
        }
    ],

    "tabBar": {
        "list": [
            {
                "iconPath": "/static/logo.png",//注意使用图片绝对路径,否则可能出现获取不到的情况
                "pagePath": "pages/index/index",
                "text": "首页"
            },
            {
                "iconPath": "/static/logo.png",
                "pagePath": "pages/my/my",
                "text": "我的"
            }
        ],
        "custom":true//关闭默认tabBar
    }
}

3.修改custom-tab-bar/index.js文件。配置list项为tabBar页面列表,每一项的 pagePath、iconPath、selectedIconPath、text为必填项,具体参考示例。页面应该已经显示了组件效果。

list: [{
                pagePath: "pages/index/index",
                iconPath: "/static/logo.png",
                selectedIconPath: "/static/logo-act.png",
                text: "首页"
            },
            {
                pagePath: "pages/my/my",
                iconPath: "/static/logo.png",
                selectedIconPath: "/static/logo-act.png",
                text: "我的"
            },
            {
                pagePath: "pages/oth/oth",
                iconPath: "/static/logo.png",
                selectedIconPath: "/static/logo-act.png",
                text: "其他"
            }
        ]

4.此时切换tabBar会出现切换异常的问题,需要在每个tabBar页面中添加如下代码即可。至此,你已经完成了组件的引入。

import {
        handleOper
} from "@/custom-tab-bar/utils/index.js"

onShow() {
        handleOper.call(this)
}

配置说明

全部在custom-tab-bar/index.js 的 data中配置。

参数名 说明 类型 例子 默认值 可选值
bg 导航栏背景色 string rgb(0,0,0,0.2) rgb(255,255,255,0.5) tabBar背景色,建议使用示例形式,可以方便配置透明度
blur 导航栏背景模糊度,bg有透明效果时生效 number 5 15 自然数
ballBg 激活的Tab,滚动球背景色 string rgb(0,0,0,0.2) rgb(255,255,255,0.2) 同bg
ballBlur 激活的Tab,滚动球模糊度,ballBg有透明效果时生效 number 5 5 自然数
selectedColor 激活的Tab的文字颜色 string green #3cc51f rgb、颜色名或16进制数
fontSize Tab文字大小 number 30 28 正整数
color 未激活的Tab文字颜色 string red gray rgb、颜色名或16进制数
type 导航栏的样式 string primary primary ripple(波纹)、primary
list tabBar的页面列表 Array [tabBarItem] - -

tabBarItem说明:

// tabBar页面列表,每一项的  pagePath、iconPath、selectedIconPath、text为必填项,如示例
list: [{
                pagePath: "pages/index/index",
                iconPath: "/static/logo.png",
                selectedIconPath: "/static/logo-act.png",
                text: "首页"
            },
            {
                pagePath: "pages/my/my",
                iconPath: "/static/logo.png",
                selectedIconPath: "/static/logo-act.png",
                text: "我的"
            }
        ]

小结

暂时先更新这些,持续更新中,若有问题欢迎打扰

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问