微信小程序自定义tabBar

自定义 tabbar

基础库 2.5.0 开始支持，低版本需做兼容处理。

自定义 tabbar 可以让开发者更加灵活地设置 tabbar 样式，以满足更多个性化的场景。

在自定义 tabbar 模式下

• 为了保证低版本兼容以及区分哪些页面是 tab 页，tabbar 的相关配置项需完整声明，但这些字段不会作用于自定义 tabbar 的渲染。
• 此时需要开发者提供一个自定义组件来渲染 tabbar，所有 tabbar 的样式都由该自定义组件渲染。推荐用 fixed 在底部的 cover-view + cover-image 组件渲染样式，以保证 tabbar 层级相对较高。
• 与 tabbar 样式相关的接口，如 wx.settabbaritem 等将失效。
• 每个 tab 页下的自定义 tabbar 组件实例是不同的，可通过自定义组件下的 gettabbar 接口，获取当前页面的自定义 tabbar 组件实例。

注意：如需实现 tab 选中态，要在当前页面下，通过 gettabbar 接口获取组件实例，并调用 setdata 更新选中态。可参考底部的代码示例。

使用流程 1. 配置信息

• 在 app.json 中的 tabbar 项指定 custom 字段，同时其余 tabbar 相关配置也补充完整。
• 所有 tab 页的 json 里需声明 usingcomponents 项，也可以在 app.json 全局开启。

示例：

{
  "tabbar": {
    "custom": true,
    "color": "#000000",
    "selectedcolor": "#000000",
    "backgroundcolor": "#000000",
    "list": [{
      "pagepath": "page/component/index",
      "text": "组件"
    }, {
      "pagepath": "page/api/index",
      "text": "接口"
    }]
  },
  "usingcomponents": {}
}

2. 添加 tabbar 代码文件

在代码根目录下添加入口文件:

custom-tab-bar/index.js
custom-tab-bar/index.json
custom-tab-bar/index.wxml
custom-tab-bar/index.wxss

3. 编写 tabbar 代码

用自定义组件的方式编写即可，该自定义组件完全接管 tabbar 的渲染。另外，自定义组件新增 gettabbar 接口，可获取当前页面下的自定义 tabbar 组件实例。

 

【说明】：本文章由站长整理发布，文章内容不代表本站观点，如文中有侵权行为，请与本站客服联系(QQ:254677821)！