小程序顶部自定义导航组件实现原理及坑分享 - WXOPEN Club

为什么使用自定义导航

对比默认导航栏，我们会更需要：

统一Android、IOS手机对于页面title的展示样式及位置
更丰富的导航栏定制效果，如添加home图标等
左上角返回事件的监听处理
统一实现双击返回顶部功能

自定义导航组件实现思路

自定义导航组件实现的核心是需要计算导航栏的真实高度

这里以官方文档->扩展能力中的Navigation组件为例分析实现思路。当使用"navigationStyle": "custom"时，默认导航被移除，页面的开始位置变成了屏幕顶部，这时我们需要实现的导航栏是在状态栏下面。

导航栏的真实高度=状态栏高度+导航栏内容。

使用wx.getSystemInfo获取到statusBarHeight便是导航栏的高度，但是导航栏内容高度呢？

有人可能觉得导航栏内容高度顾名思义就是导航栏内容高度啊，内容撑起还用管嘛！要，必须要！
因为右上角胶囊按钮是原生加载的，我们的导航栏内容需要正好贴在胶囊的下方且垂直居中。

导航栏内容高度=（胶囊按钮的顶部距离 - 状态高度）*2 + 胶囊高度

如何计算胶囊的数据呢？幸运的是我们有 wx.getMenuButtonBoundingClientRect() 获取胶囊按钮的布局位置信息，那么动态计算导航栏的内容高度就很方便啦。
好了，以上就是动态计算的核心思路，我们再来看官方Navigation组件高度是怎么实现的

page{--height:44px;--right:190rpx;}
.weui-navigation-bar .android{--height:48px;--right:222rpx}
.weui-navigation-bar__inner{
	position:fixed;top:0;left:0;z-index:5001;display:flex;align-items:center;
	height:var(--height);padding-right:var(--right);width:calc(100% - var(--right))
}

导航栏内容的高度是通过- -height这个css变量提前声明好的，安卓机型会重新覆盖为新的css变量值，目前没发现有适配问题。
官方就是官方啊，具体尺寸都知道，那就不用一番计算周折啦，直接拿来主义即可。
导航的布局位置已经搞定啦，剩下就是写具体的内容，不同业务实现需求不同这里就不一一赘述了。

完善官方顶部导航组件

本着拿来主义，直接使用官方Navigation组件，但在实际业务开发中还是遇到不少需要自定义的需求，就比如：

loadding样式没实现
标题内容超出没有出现省略号
和原生顶部的样式不兼容，导致单个页面引入时跳转有明显差异出现
没有双击返回顶部功能开关功能
引入页面需要获取导航栏的高度，来控制其他元素距离顶部的位置，
不能根据页面栈数据动态显示隐藏back按钮，

针对以上需求，我们对官方的组件进行二次完善开发，满足常规的自定义需求绰绰有余，直接引入开箱即用。
源码使用示例 https://github.com/YuniorZen/minicode-debug/tree/master/minicode02

使用说明

/*自定义头部导航组件，基于官方组件Navigation开发。*/

<navigation-bar title="会员中心" bindgetBarInfo="getBarInfo"></navigation-bar>

组件属性列表

属性	类型	描述
bindgetBarInfo	function	组件实例载入页面时触发此事件，首参为event对象，event.detail携带当前导航栏信息，如导航栏高度 event.detail.topBarHeight
bindback	function	点击back按钮触发此事件响应函数
backImage	string	back按钮的图标地址
homeImage	string	home按钮的图标地址
ext-class	string	添加在组件内部结构的class，可用于修改组件内部的样式
title	string	导航标题，如果不提供为空
background	string	导航背景色，默认#ffffff
color	string	导航字体颜色
dbclickBackTop	boolean	是否开启双击返回顶部功能，默认true
border	boolean	是否显示顶部导航下边框分割线，默认false
loading	boolean	是否显示标题左侧的loading，默认false
show	boolean	显示隐藏导航，隐藏的时候navigation的高度占位还在,默认true
left	boolean	左侧区域是否使用slot内容，默认false
center	boolean	中间区域是否使用slot内容，默认false

Slot

name	描述
left	左侧slot，在back按钮位置显示，当left属性为true的时候有效
center	标题slot，在标题位置显示，当center属性为true的时候有效