小程序组件—自定义顶部导航

微信小程序凭借着“不占内存，即用即走”等特点，加上微信的社交的属性，其用户量一路保持快速的增长。对其的应用要求也日渐增高，使用更多样化、个性化。其中，对顶部导航的自定义实现，因交互功能成了一个普遍需要实现的组件，而尤因其不同设备下样式的兼容问题 如何更优雅的实现 使其成为大家讨论的热点。
下面我们从对其的设计、实现、使用上进行详细阐述，让大家更加了解这个组件。原创文章，若有写的不妥之处，欢迎大家指出更正。

自定义导航的设计

界面设计

目前，大多小程序对自定义导航的设计是：标题居中；左侧胶囊包裹返回上一页按钮和到首页按钮，要和右侧系统默认胶囊样式布局一致。效果如下：

顶部导航设计效果图

功能设计

主要功能如下：

1. 自定义 小程序 顶部导航 ：微信版本号 <7 的无此功能
2. 去首页 功能 ：首页没有此功能
3. 返回 功能：无上一页没有此功能
4. 模拟系统默认样式：和系统默认右边胶囊样式保持一致
5. 居中显示标题：字数过多时 省略号代替

详细实现

布局样式实现

这个组件的实现的主要的重点在于不同设备上的样式兼容。由于右侧胶囊在不同设备下的表现是不一样的，所以左侧胶囊的布局样式要随不同设备进行自适应，既左侧胶囊的高度间距等样式数据要先计算出来再赋予其值。故难点就在于如何获得这些值。经过一番针对个别手机的兼容踩坑操作（此处省略一万字...😢），最终得到正解（此处感谢小伙伴的雪中送炭🙏），那就是可以一劳永逸的wx.getMenuButtonBoundingClientRect()

wx.getMenuButtonBoundingClientRect()
获取菜单按钮（右上角胶囊按钮）的布局位置信息。坐标信息以屏幕左上角为原点。
菜单按钮的布局位置信息：
width 宽度(px)
height 高度(px)
top 上边界坐标(px)
right 右边界坐标(px)
bottom 下边界坐标(px)
left 左边界坐标(px)

有了这个关键点，下面带着大家看具体如何一步步优雅地完美地实现这个组件。
首先获取布局信息对象：

let menuRect = wx.getMenuButtonBoundingClientRect()

1、实现左侧胶囊
获取左侧胶囊的高度：

this.height_capsule = menuRect.height

赋值给view :

<view class="nav_capsule" style="height:{{height_capsule}}px">

然后，对胶囊内部采用flex对其进行布局及一些细节处理，胶囊的单独实现就完成了。
2、实现左侧胶囊与右侧胶囊对齐
在其外包一层父级view，即导航条。对导航条进行与右侧一样的上边距和下边距填充。

<view class="navbar" style="padding-top: {{paddingTop}}px; padding-bottom: {{paddingBottom}}px;">

获取边距值：

this.paddingTop = menuRect.top
this.paddingBottom = menuRect.top - wepy.getSystemInfoSync().statusBarHeight

这样，此时对齐效果就实现了。
3、自定义标题垂直水平居中
我们对导航条内部进行flex布局，由于右侧胶囊是系统默认的，要使标题块居中，就需要做一个右侧胶囊占位，同时给导航左右设置那边距。
导航左右设置内边距：

padding-left:20rpx;
padding-right:20rpx;

右侧胶囊占位：

<view class="nav_right" style="height: {{height_capsule}}px; width: {{width_capsule}}px;"></view>
this.width_capsule = menuRect.width

此时，标题块就处于居中的位置了。然后对齐进行垂直水平居中和省略号控制就好了。
4、完善导航条布局样式
上面，一个自定义导航条的样式布局就基本完成。但要达到可以很优雅地被使用还是需要一些完善的。
-设置定位：使其被任意页面调用都处于视窗最顶部固定不变的位置。

position: fixed;top: 0;

设置层级：使其被任意页面调用都处于页面中最高层级视窗的最前面。

z-index: 99999;

增加占位块：使其使其被任意页面调用都不会遮挡其他页面元素。

<view class="placeholder" wx:if="{{navbar.flag}}" style="height:{{height}}px"></view>
this.height = menuRect.bottom + this.paddingBottom;
.placeholder{width: 100%;}

然后，用一个view包裹navbar和placeholder，就是一个完善的自定义导航条了。

功能实现

1、显示自定义小程序顶部导航
自定义导航，需要在单个页面中设置参数：

config = { navigationStyle: "custom" };

，由于在对局部页面进行自定义时，

客户端 7.0.0 以下版本，navigationStyle 只在 app.json 中生效。

所以，我们要对版本进行兼容判断，是否显示自定义导航。

this.navbar.flag = wx.getSystemInfoSync().version.split('.')[0] >= 7 ? true : false
<view class="navbar-box" wx:if="{{navbar.flag}}">

2、显示返回上一页按钮
如果没有上一页，就不需要返回上一页功能：

this.showBack = getCurrentPages().length > 1 ? true : false
<button class="nav_back" @tap="navBack" wx:if="{{showBack}}">

如果此按钮不显示，只剩下去首页按钮，分割线也要隐藏掉：

<view class="divide" wx:if="{{showBack}}"></view>

到此，一个自定义导航组件就完整地实现了。还在为兼容或者调用时需要适配很多的问题而一筹莫展的童鞋，看到这儿是不是可以展颜了呀。完整代码呈现如下：
github分享：https://github.com/linger777/xiaochengxu/blob/master/xcxmodule/src/readmes/NAVBAR.md
gitee分享：https://gitee.com/linger777/xiaochengxu/blob/master/xcxmodule/src/readmes/NAVBAR.md
小程序片段分享：https://developers.weixin.qq.com/s/AzGaZTmV7D8j
有需要的童鞋自取。下面给大家介绍下如何使用：

使用说明

1. 定义页面自定义顶部导航

config = { navigationStyle: "custom" };

1. 引入组件

import navbar from '@/components/navbarNew'

2. 注册组件

components = {navbar, }

3. 调用组件

<navbar :navbar.sync="navbar"></navbar>

4. 赋值

    data = {
        navbar: {
            flag: true, //是否使用navbar
            title: '顶部导航', // 自定义导航标题
            height: '' // 导航高度
        },
    }

5. 如页面遇到有 sticky \ fixed 定位的view，按需要可以通过加入style进行调整

style="top: {{navbar.flag ? navbar.height : 0}}rpx;"

以上就是对自定义顶部导航的全部分享，如有不解，欢迎留言讨论。