如何制作一个自定义小程序导航栏

一、小程序导航栏配置

小程序中.json 文件可以用来对微信小程序进行全局配置和页面配置。关于导航栏的设置,有3个配置,但是相对局限,只能设置背景颜色、标题标题内容及字体颜色,除此之外都是默认样式。


导航栏配置项

二、自定义导航栏

因为默认的导航栏配置相对限制,所以有时不能满足我们的UI设计要求。比如项目设计了导航栏背景图,或是非纯色的渐变背景等,这个时候我们就需要拥有可以自定义导航栏样式的权限了。
微信也考虑到了这个问题,所以微信提供了一个配置项,开发者可选择自定义导航栏还是使用默认导航栏。不过,这个配置项是有一定的版本要求的,所以如果项目是有面向低版本的,需要考虑兼容性问题。

{
"navigationStyle":"custom"
}

关于配置项的解释:


image.png

三、实例操作演示

虽然配置项仅仅是一句代码,但是,在项目实际运用中,并不是一句代码就完成所有,配置自定义后会引起很多后续展示问题,需要补充处理。
下面通过我自己实际运用的项目,记录下在配置自定义导航栏后的相关处理问题和操作,以供后续回忆和大家相互学习。

步骤一

首先要分析自己的项目页面的导航栏情况,是所有页面都使用自定义;还是部分页面使用自定义,部分使用默认;然后决定要使用全局配置还是页面局部配置,还是两者结合。

  1. 全部使用自定义导航栏:
    全局配置项中配置“自定义导航栏”;
app.json
{
  "window": {
    "navigationStyle": "custom"
  }
}
  1. 部分使用自定义,部分使用默认:
    (1)如果是使用自定义的页面 多于 默认,则 全局配置+局部页面配置
    例如:项目中getCode页面是使用默认导航栏的,其他使用自定义。
app.json
{
  "window": {
    "navigationStyle": "custom"
  }
}
getCode.json
{
  "navigationStyle": "default"
}
    **在使用全局配置之后,要注意把非自定义导航栏的页面配置回默认。**

(2)如果是使用默认的页面 多于 自定义,则只进行 局部页面配置
例如:index页面要使用自定义导航栏。

index.json
{
  "navigationStyle": "custom"
}

完成后,自定义的页面导航栏会消失,只剩下右侧的胶囊栏,整个页面内容会上移顶到展示屏幕的最顶端。


展示

步骤二

实现自己的自定义背景样式。
在这一步,我的项目需要的是用一个有创意的大背景图,作为导航栏跟部分页面内容的背景。所以在导航栏消失后,我只需要本来页面的内容布局中,编写最顶端的背景图布局和样式,它就会自动展现到最上方。
这里需要根据自己的项目要求去实现。

步骤三

编写一个自适应各种屏幕的自定义基本导航栏。(高度与右侧的胶囊匹配,字体大小适中,重点是在各种尺寸显示屏上正常)

根据网上查询的一些资料和我自己的实际操作,总结的思路如下:

  1. 进入页面后,动态获取右上角胶囊按钮的布局位置信息;
  2. 计算出导航栏的高度和上边距等信息;
  3. 然后动态设置导航栏的相关信息值,设置适当的字体大小等样式;

代码展示如下:
index.js

/*动态计算导航栏*/
  autoCalcBar: function () {
    let systemInfo = wx.getSystemInfoSync(); //获取系统信息
    let headerBtnPos = wx.getMenuButtonBoundingClientRect(); //获取菜单按钮(右上角胶囊按钮)的布局位置信息
    let customBarH = (headerBtnPos.top - systemInfo.statusBarHeight) * 2 + headerBtnPos.height + 2; //上下内边距+胶囊高度+胶囊border
    let customBarTop = systemInfo.statusBarHeight; //导航栏上顶距离
    let barfontSize = 0;
    if (systemInfo.screenWidth >= 768) {
      barfontSize = 16;
    }
    this.setData({
      customBarH: customBarH,
      customBarTop: customBarTop,
      barfontSize: barfontSize,
      showNavBar: true
    });
  }

index.html

<view wx:if="{{showNavBar}}" style="height:{{customBarH+'px'}};line-height:{{customBarH+'px'}};padding-top:{{customBarTop+'px'}};{{barfontSize!=0?'font-size:'+barfontSize+'px':''}}" class="project-title">wechat</view>

其中重点关注两个API:

  1. wx.getSystemInfoSync()
    可以获取系统的各项信息,如设备宽度高度、屏幕宽度高度、导航栏高度等等。
  2. wx.getMenuButtonBoundingClientRect()
    可以获取菜单按钮(即右上角胶囊按钮)的布局位置信息,包括高度宽度,距左侧距离,距顶端距离等。

步骤四

在实现自适应的导航栏时,要考虑到页面内容可能超过一页的展示情况。所以,自定义的导航栏元素不能在正常流当中,应该设置相对于浏览器窗口的绝对定位,让导航栏一直固定在上方,不随页面滚动而移动。
样式设置展现:

.project-title {
  position: fixed;
  width: 100%;
  z-index: 100;
  text-align: center;
  font-size: 32rpx;
  font-weight: 600;
  color: #fff;
}

步骤五

发现首页可能存在不止一页的展示情况后,当页面内容滚动到顶部,可能就会存在与导航栏重叠的部分,如果导航栏维持原本样式,这样就会呈现很奇怪的展示。

调整的实现思路:

  1. 计算页面内容中距顶部最近元素与屏幕上方之间的距离,作为滚动距离的限制边界值;
  2. 监听首页滚动距离;
  3. 根据滚动距离与边界值的大小比较,判断页面内容是否接近导航栏,来动态变换自定义背景图和顶部导航栏样式。(当页面内容与导航栏重叠,背景图隐藏,导航栏应该恢复为白底黑字的常见样式)

代码展示:
index.js

/*监听用户滑动页面事件*/
  onPageScroll: function (obj) {
    var scrollTop = obj.scrollTop;
    if (scrollTop >= this.data.scrollLimit) {
      this.setData({
        headerIsChange: true
      });
    } else {
      this.setData({
        headerIsChange: false
      });
    }
  },
/*动态计算首页滚动导致header变化的高度限制*/
  calcScrollLimit: function () {
    var self = this;
    let query = wx.createSelectorQuery();
    query.select('#user_info').boundingClientRect(function (rect) { //距顶部最近的元素为id=“user_info”元素
      let top = rect.top;
      self.setData({
        scrollLimit: top - self.data.customBarH - self.data.customBarTop - 5 //个人信息模块距顶部高度-导航栏高度-导航栏距顶部高度
      });
    }).exec();
  },

index.html

<view class="header-wrap {{headerIsChange?'change-header-wrap':''}}">
    <image src="/images/index/index_bar_bg.png" class="bar-bg"></image>
    <view wx:if="{{showNavBar}}" style="height:{{customBarH+'px'}};line-height:{{customBarH+'px'}};padding-top:{{customBarTop+'px'}};{{barfontSize!=0?'font-size:'+barfontSize+'px':''}}" class="project-title">wechat</view>
</view>

其中,值得关注的技术点:

  1. 小程序中如何获取Dom元素节点。详细可以查看微信官方提供的小程序文档:
    返回一个 SelectorQuery 对象实例
    通过这个API就可以获取到任一个DOM元素的信息,如上边界坐标、宽度、高度、竖直滚动位置等等。
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 219,427评论 6 508
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 93,551评论 3 395
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 165,747评论 0 356
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,939评论 1 295
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,955评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,737评论 1 305
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,448评论 3 420
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,352评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,834评论 1 317
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,992评论 3 338
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 40,133评论 1 351
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,815评论 5 346
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,477评论 3 331
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 32,022评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,147评论 1 272
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,398评论 3 373
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 45,077评论 2 355

推荐阅读更多精彩内容