评论

自定义navigationBar顶部导航栏,兼容适配所有机型(附完整案例)

自定义navigationBar顶部导航栏,兼容适配所有机型,附上完整案例!

前言

navigationBar相信大家都不陌生把?今天我们就来说说自定义navigationBar,把它改变成我们想要的样子(搜索框+胶囊、搜索框+返回按钮+胶囊等)。

思路

  • 隐藏原生样式
  • 获取胶囊按钮、状态栏相关数据以供后续计算
  • 根据不同机型计算出该机型的导航栏高度,进行适配
  • 编写新的导航栏
  • 引用到页面

正文

一、隐藏原生的navigationBar

window全局配置里有个参数:navigationStyle(导航栏样式),default=默认样式,custom=自定义样式。

"window": {
	"navigationStyle": "custom"
}

让我们看看隐藏后的效果:

可以看到原生的navigationBar已经消失了,剩下孤零零的胶囊按钮,胶囊按钮是无法隐藏的。

二、准备工作
1.获取胶囊按钮的布局位置信息

我们用wx.getMenuButtonBoundingClientRect()【官方文档】获取胶囊按钮的布局位置信息,坐标信息以屏幕左上角为原点:

const menuButtonInfo = wx.getMenuButtonBoundingClientRect();
width height top right bottom left
宽度 高度 上边界坐标 右边界坐标 下边界坐标 左边界坐标

下面是官方给的示意图,方便大家理解几个坐标。

2.获取系统信息

用wx.getSystemInfoSync()【官方文档】获取系统信息,里面有个参数:statusBarHeight(状态栏高度),是我们后面计算整个导航栏的高度需要用到的。

const systemInfo = wx.getSystemInfoSync();
三、计算公式

我们先要知道导航栏高度是怎么组成的,
计算公式:导航栏高度 = 状态栏高度 + 44

实例 【源码下载】

自定义导航栏会应用到多个、甚至全部页面,所以封装成组件,方便调用;下面是我写的一个简单例子:

app.js

App({
    onLaunch: function(options) {
        const that = this;
        // 获取系统信息
        const systemInfo = wx.getSystemInfoSync();
        // 胶囊按钮位置信息
        const menuButtonInfo = wx.getMenuButtonBoundingClientRect();
        // 导航栏高度 = 状态栏高度 + 44
        that.globalData.navBarHeight = systemInfo.statusBarHeight + 44;
        that.globalData.menuRight = systemInfo.screenWidth - menuButtonInfo.right;
        that.globalData.menuBotton = menuButtonInfo.top - systemInfo.statusBarHeight;
        that.globalData.menuHeight = menuButtonInfo.height;
    },
    // 数据都是根据当前机型进行计算,这样的方式兼容大部分机器
    globalData: {
        navBarHeight: 0, // 导航栏高度
        menuRight: 0, // 胶囊距右方间距(方保持左、右间距一致)
        menuBotton: 0, // 胶囊距底部间距(保持底部间距一致)
        menuHeight: 0, // 胶囊高度(自定义内容可与胶囊高度保证一致)
    }
})

app.json

{
    "pages": [
        "pages/index/index"
    ],
    "window": {
        "navigationStyle": "custom"
    },
    "sitemapLocation": "sitemap.json"
}

下面为组件代码:
/components/navigation-bar/navigation-bar.wxml

<!-- 自定义顶部栏 -->
<view class="nav-bar" style="height:{{navBarHeight}}px;">
    <input class="search" placeholder="输入关键词!" style="height:{{menuHeight}}px; min-height:{{menuHeight}}px; line-height:{menuHeight}}px; left:{{menuRight}}px; bottom:{{menuBotton}}px;"></input>
</view>

<!-- 
    内容区域:
    自定义顶部栏用的fixed定位,会遮盖到下面内容,注意设置好间距
-->
<view class="content" style="margin-top:{{navBarHeight}}px;"></view>

/components/navigation-bar/navigation-bar.json

{
  "component": true
}

/components/navigation-bar/navigation-bar.js

const app = getApp()
Component({
    properties: {
        // defaultData(父页面传递的数据-就是引用组件的页面)
        defaultData: {
            type: Object,
            value: {
                title: "我是默认标题"
            },
            observer: function(newVal, oldVal) {}
        }
    },
    data: {
        navBarHeight: app.globalData.navBarHeight,
        menuRight: app.globalData.menuRight,
        menuBotton: app.globalData.menuBotton,
        menuHeight: app.globalData.menuHeight,
    },
    attached: function() {},
    methods: {}
})

/components/navigation-bar/navigation-bar.wxss

.nav-bar{ position: fixed; width: 100%; top: 0; color: #fff; background: #000;}
.nav-bar .search{ width: 60%; color: #333; font-size: 14px; background: #fff; position: absolute; border-radius: 50px; background: #ddd; padding-left: 14px;}

以下是调用页面的代码,也就是引用组件的页面:
/pages/index/index.wxml

<navigation-bar default-data="{{defaultData}}"></navigation-bar>

/pages/index/index.json

{
    "usingComponents": {
        "navigation-bar": "/components/navigation-bar/navigation-bar"
    }
}

/pages/index/index.js

const app = getApp();
Page({
    data: {
        // 组件参数设置,传递到组件
        defaultData: {
            title: "我的主页", // 导航栏标题
        }
    },
    onLoad() {
        console.log(this.data.height)
    }
})

效果图:

好了,以上就是全部代码了,大家可以文中复制代码,也可以【下载源码】,直接到开发者工具里运行,记得appid用自己的或者测试哦!

下面附几张其它小程序的效果图,大家也可以尝试照着做:

总结

  • 本文写了自定义navigationBar的一些基础性东西,里面涉及组件用法、参数传递、导航栏相关。
  • 由于测试环境有限,大家在使用时如果发现有什么问题,希望及时反馈,以供及时更新帮助更多的人!
  • 大家有什么疑问,欢迎评论区留言!
最后一次编辑于  2022-06-23  
点赞 21
收藏
评论

10 个评论

  • November.
    November.
    2020-09-25

    谁告诉你“导航栏高度 = 状态栏到胶囊的间距(胶囊距上距离-状态栏高度) * 2 + 胶囊高度 + 状态栏高度,自己去刘海屏的iphone上测试一下。用自己写的menu.bottom + menu.top - statusHeight高度的导航栏和系统自带的导航栏比对一下高度,明显矮了一点。

    2020-09-25
    赞同 2
    回复 4
    • 奋斗℡志锋 
      奋斗℡志锋 
      2020-09-27
      理论上不该出现,但是确实我也出现了,矮了一点
      2020-09-27
      回复
    • November.
      November.
      2020-09-29回复奋斗℡志锋 
      导航栏高度就等于statusHeight+44px,任何机型都是
      2020-09-29
      4
      回复
    • Huān
      Huān
      2023-08-15回复November.
      好像ipad不是
      2023-08-15
      回复
    • 我,秦始皇
      我,秦始皇
      02-21回复November.
      andriod 就不是,看vx提供的navi例子。
      你调试时候总是44,是因为他里面还有个 devtools 的判断,绕过 了android的判断。
      android是48px.
      02-21
      1
      回复
  • Emmm
    Emmm
    2022-07-12

    软键盘会把顶部导航栏顶飞

    2022-07-12
    赞同 1
    回复 2
  • 木子尔玉
    木子尔玉
    07-18

    可以把 tabs 标签直接放入导航栏吗?然后下面的页面可以左右滑动切换,就如腾讯视频小程序 短片界面的效果

    07-18
    赞同
    回复
  • 王William
    王William
    2023-10-10

    不使用setData 无法更新变量值!

    2023-10-10
    赞同
    回复
  • 諶白文
    諶白文
    2023-06-20

    感谢分享,我遇到一个问题,页面上下拉动时,黑色背景的导航条也跟着往下走,漏出顶部一片白。

    试着把page设置为100%高度,结果触底又不更新了。。。。

    有什么办法解决么?

    2023-06-20
    赞同
    回复 1
    • 諶白文
      諶白文
      2023-06-20
      补图
      2023-06-20
      回复
  • 坏蛋
    坏蛋
    2022-06-29

    我想在胶囊平齐的位置包括到手机顶部时间位置都改背景怎么改?


    2022-06-29
    赞同
    回复
  • 沐千熏
    沐千熏
    2022-06-16

    为什么我的这个 <view wx:for> 会在滑动时覆盖掉导航栏,底部的不会(用的是vant的tab标签页)。

    2022-06-16
    赞同
    回复 2
    • 沐千熏
      沐千熏
      2022-06-16
      这是头部导航栏,没有像你那样做导入方式。我是直接写在要用的那个页面的。
      2022-06-16
      回复
    • 沐千熏
      沐千熏
      2022-06-16
      这就是我的滤网列表代码,和侧边导航栏代码。
      2022-06-16
      回复
  • 自来水管饱
    自来水管饱
    2021-03-20

    你好,我有一点没看懂,在自定义组件的navigation-bar.wxml文件里面,为啥需要多加一块那个内容区域啊?

    2021-03-20
    赞同
    回复
  • zxy_01
    zxy_01
    2020-03-29

    感谢分享

    还有navigation-bar.wxml这里少了个"{"

    2020-03-29
    赞同
    回复
  • Admin ²º²⁴
    Admin ²º²⁴
    2020-03-26

    感谢分享。不过里面的图片貌似看不了挖,期待修复图片链接后的版本

    2020-03-26
    赞同
    回复 10
    • 淼淼
      淼淼
      2020-03-26
      已经修复了,谢谢反馈!
      2020-03-26
      回复
    • Admin ²º²⁴
      Admin ²º²⁴
      2020-03-26回复淼淼
      恩,这个是没有返回的navbar啊?
      2020-03-26
      回复
    • 淼淼
      淼淼
      2020-03-26
      嗯,组件里就放了搜索,需要其它的可以自行加!空了,我也会把目前几个主流的样式都写出来!
      2020-03-26
      回复
    • Admin ²º²⁴
      Admin ²º²⁴
      2020-03-26回复淼淼
      不错。这里我提醒下这里可能会有坑:
      getMenuButtonBoundingClientRect和getSystemInfoSync有些机型会出现第一次获取不到或者获取的值为0的情况。
      你社区搜索下。
      比如这个:
      在 iOS 下的 tabBar 页面调用 getMenuButtonBoundingClientRect 返回值不正确 | 微信开放社区
      https://developers.weixin.qq.com/community/develop/doc/00080c632940f8e41c6802dae5a414?highLine=getMenuButtonBoundingClientRect
      亲身经历的被坑事件。大家要针对这2个API做好补救方案。给个默认值或者定时器重复获取
      还有在onLaunch执行getSystemInfo的同步版本getSystemInfoSync,可以考虑用异步方案getSystemInfo。这样onLaunch能更快点
      2020-03-26
      回复
    • 西红柿
      西红柿
      2020-03-26
      其实有个终极方案,不用这么麻烦的,之前也跟官方确认过这个问题的。你拿到statusBarHeight,加44px就是他的高度了。适配到所有。我们目前就是这样算的
      2020-03-26
      1
      回复
    查看更多(5)
登录 后发表内容