自定义导航栏左上角胶囊按钮返回、首页小房子

示例项目地址:https://github.com/Shay0921/header-navbar

在小程序中,从转发出来的小程序消息卡片进入,因为页面栈中只有一个,所以不会出现返回按钮,对于一些电商平台来说,当商品被转发后会很影响客户查看其它产品和首页,这时候就需要使用自定义导航栏自己写一个“胶囊按钮”。如下图所示:

从别的页面点到商品页时会有返回和首页按钮;


当从分享页进入到商品页时,因为页面栈只有一个,所以只有首页按钮;


首先我们需要如何开启自定义导航栏,查看手册后会发现一个页面配置项:navigationStyle


之前的版本此配置项只能在app.js中配置,是全局的属性,而现在可以在单独的页面json中配置,实现单独页面自定义导航栏。

整体思路

当使用了navigationStyle:custom后,之前的顶部标题栏会被删除,右侧的胶囊按钮则会固定在右上角。然后在当前页面添加了三个view(状态栏、标题栏、主体内容),可以看出三块的布局,我直接写死的高度:状态栏20px,标题栏44px。这个是自定义导航栏的关键,需要去计算这两块的高度,还有返回|首页胶囊按钮的位置。基础库 2.1.0开始可以使用wx.getMenuButtonBoundingClientRect()来获得右侧胶囊按钮的位置信息,而有了这个信息,就能相对的算出我们想要在左侧添加的胶囊按钮的位置。通过wx.getSystemInfoSync()中的statusBarHeight找到状态栏的高度


目录结构

全局变量

app.js

在app.js中要先获得状态栏高度和右侧胶囊位置信息

这里需要注意wx.getMenuButtonBoundingClientRect(),并不是像wx.getSystmInfo一样有success回调函数,而是像对象一样wx.getMenuButtonBoundingClientRect().height来使用。

组件代码

headerNavbar.wxml    

为了适配不同手机屏幕,高度和胶囊按钮的位置都需要在html里面赋值,下面会详细的说明高度如何计算。在自定义导航栏组件中分为两部分,一个是顶部的导航栏另一个是自己写的loading。

因为自定义导航栏是fixed到顶部的,为了保证不挡住下面的主体内容,我们需要在导航栏和主体内容之间添加一个跟导航栏相同的高度,class先叫做box。这样可以保证导航栏不挡着主体内容。但是会出现另一个问题,如果此页面支持下拉刷新,那么导航栏会把小程序原生的loading样式挡住,而在主体内容的前面会出现一个空白的box,虽说不影响使用,但是在用户看来会很奇怪,莫名其妙的多出来一块,box只有在loading结束后才会上去。所以在这里需要自己手写一个loading的动画效果放在组件的最底下,高度跟导航栏一样。

可以看到下面的最终效果,蓝色导航条下面的三个点是小程序原生loading,再下面三个小点是自己写的loading。

而我们想要的效果则是,当小程序原生的loading被当时,自己写的loading就可以替代原生的loading

headerNavbar.js

状态栏高度= app.globalData.systeminfo.statusBarHeight

需要注意胶囊位置信息的原点是在页面的左上角,所以需要转换一下,把原胶囊位置信息起名为胶囊,转换后的叫做现胶囊。

/**

* iphone6 的胶囊位置信息

*

wx.getMenuButtonBoundingClientRect() 坐标信息以屏幕左上角为原点

现胶囊上边距 = 胶囊上边界坐标 - 状态栏高度

现胶囊右边距 = 屏幕宽度 - 胶囊右边界坐标

现胶囊下边距 = 胶囊下边界坐标 - 胶囊高度 - 状态栏高度

导航栏高度 = 胶囊下边界坐标+ 现胶囊下边距

注意:胶囊下边界坐标包含了状态栏、胶囊高度和状态栏和胶囊高度之间的距离,因为胶囊是居中在导航栏里的,所以上边距与下边距应该一致,所以是胶囊下边界坐标 - 胶囊高度 - 状态栏高度。

通过getCurrentPages() 来判断当前页面是否从分享页进入,因为如果从分享页进入页面栈中应该只有一条数据,在跳转到其他页面时页面栈的length则会增加,在其他页面就会显示出返回和首页按钮。

注意:微信7.0.0支持wx.getMenuButtonBoundingClientRect(),如果想兼容低版本的微信,只能把导航栏的高度写死,通过一些大佬的计算得出的高度:

'iPhone': 64,

'iPhone X': 88,

'android': 68

具体查看:

https://developers.weixin.qq.com/community/develop/doc/0006c012dc8028f04b070dd0551004

如果你使用wx.getMenuButtonBoundingClientRect()得到信息有小数,如下所示

{height:24, width: 65.25, top: -0.5, bottom: -0.5, right: 101.25}

那么你可能是把开发工具中的视图缩放了,还原成100%就正常了。


headerNavbar.wxss

引用组件页面代码

navigationStyle.json

先在需要使用自定义导航栏的页面json中添加navigationStyle:custom

enablePullDownRefresh:true         开启下拉刷新

backgroundTextStyle: light是把loading的样式改成白色,这样就不会显示出来loading的三个点

navigationStyle.wxml

navigationStyle.js

注意:虽说这么做在小程序开发工具中看起来都是对的,得到的导航栏高度也是64px但是在真机上测试后,还是有偏差,在iphone8 plus上高度是60px。

可以通过这张图明显看到差了几px,如果你是单独几个页面使用自定义导航,细心的用户可能会发现,但是基本不影响。如果是全局使用自定义导航,那就不存在这个问题了。

示例项目地址:https://github.com/Shay0921/header-navbar

你可能感兴趣的:(自定义导航栏左上角胶囊按钮返回、首页小房子)