小程序模板網(wǎng)

小程序自定義導(dǎo)航欄,兼容適配所有機(jī)型(附完整案例)

發(fā)布時(shí)間:2020-05-14 10:21 所屬欄目:小程序開(kāi)發(fā)教程

大部分情況下我們都是使用微信官方自帶的 navigationBar 配置 ,但有時(shí)候我們需要在導(dǎo)航欄集成搜索框、自定義背景圖、返回首頁(yè)按鈕等。

思路

  • 隱藏官方導(dǎo)航欄

  • 獲取膠囊按鈕、狀態(tài)欄相關(guān)數(shù)據(jù)以供后續(xù)計(jì)算

  • 根據(jù)不同機(jī)型計(jì)算導(dǎo)航欄高度

  • 編寫(xiě)新的導(dǎo)航欄

  • 頁(yè)面引用自定義導(dǎo)航

正文

隱藏官方導(dǎo)航欄

隱藏導(dǎo)航欄可以全局配置,也可以單獨(dú)頁(yè)面配置,具體根據(jù)業(yè)務(wù)需求來(lái)。

全局隱藏

//app.json
"window": {
   "navigationStyle": "custom"
}
復(fù)制代碼

頁(yè)面隱藏

//page.json
{
  "navigationStyle": "custom"
}
復(fù)制代碼

獲取膠囊按鈕、狀態(tài)欄相關(guān)數(shù)據(jù)以供后續(xù)計(jì)算

公式:導(dǎo)航欄高度 = 狀態(tài)欄到膠囊的間距(膠囊距上邊界距離-狀態(tài)欄高度) * 2 + 膠囊高度 + 狀態(tài)欄高度。 由公式得知,我們需要獲取 狀態(tài)欄高度 膠囊高度 膠囊距上距離

注:狀態(tài)欄到膠囊的間距 = 膠囊到下邊界距離。所以這里需要*2

狀態(tài)欄高度

用 wx.getSystemInfoSync() 官方API 可以獲取系統(tǒng)相關(guān)信息, statusBarHeight 屬性可以獲取到狀態(tài)欄高度

const statusBarHeight = wx.getSystemInfoSync().statusBarHeight;
復(fù)制代碼

膠囊高度和膠囊距上邊界距離

用 wx.getMenuButtonBoundingClientRect() 官方API 可以獲取菜單按鈕膠囊按鈕的布局位置信息。

const menuButtonInfo = wx.getMenuButtonBoundingClientRect();//膠囊相關(guān)信息
const menuButtonHeight = menuButtonInfo.height //膠囊高度
const menuButtonTop = menuButtonInfo.top//膠囊距上邊界距離
復(fù)制代碼

實(shí)例

一般情況下,我們需要在運(yùn)用啟動(dòng)的初始化生命周期鉤子進(jìn)行計(jì)算相關(guān)的數(shù)據(jù),也就是入口文件 app.js 的 onLaunch 生命周期鉤子

//app.js
App({
  onLaunch: function () {
    this.setNavBarInfo()
  },
  
  globalData: {
    //全局?jǐn)?shù)據(jù)管理
    navBarHeight: 0, // 導(dǎo)航欄高度
    menuBotton: 0, // 膠囊距底部間距(保持底部間距一致)
    menuRight: 0, // 膠囊距右方間距(方保持左、右間距一致)
    menuHeight: 0, // 膠囊高度(自定義內(nèi)容可與膠囊高度保證一致)
  },

  /**
   * @description 設(shè)置導(dǎo)航欄信息
   */
  setNavBarInfo () {
    // 獲取系統(tǒng)信息
    const systemInfo = wx.getSystemInfoSync();
    // 膠囊按鈕位置信息
    const menuButtonInfo = wx.getMenuButtonBoundingClientRect();
    // 導(dǎo)航欄高度 = 狀態(tài)欄到膠囊的間距(膠囊距上距離-狀態(tài)欄高度) * 2 + 膠囊高度 + 狀態(tài)欄高度
    this.globalData.navBarHeight = (menuButtonInfo.top - systemInfo.statusBarHeight) * 2 + menuButtonInfo.height + systemInfo.statusBarHeight;
    this.globalData.menuBotton = menuButtonInfo.top - systemInfo.statusBarHeight;
    this.globalData.menuRight = systemInfo.screenWidth - menuButtonInfo.right;
    this.globalData.menuHeight = menuButtonInfo.height;
  }
})
復(fù)制代碼

頁(yè)面引用自定義導(dǎo)航

//page.wxml
<view class="nav" style="height:{{navBarHeight}}px;">
  <!-- 膠囊區(qū)域 -->
  <view class="capsule-box" style="height:{{menuHeight}}px; min-height:{{menuHeight}}px; line-height:{{menuHeight}}px; bottom:{{menuBotton}}px;">
    <view class="nav-handle">
      <image class="nav-back-icon" src="/images/nav_back.png" bind:tap="navToBackLastPage"></image>
      <image class="nav-home-icon" src="/images/nav_home.png" bind:tap="navToHomePage"></image>
    </view>
    <view class="nav-title">導(dǎo)航標(biāo)題</view>
  </view>
</view>
復(fù)制代碼
// page.js
const app = getApp()
Page({

  /**
   * 頁(yè)面的初始數(shù)據(jù)
   */
  data: {
    navBarHeight: app.globalData.navBarHeight,//導(dǎo)航欄高度
    menuBotton: app.globalData.menuBotton,//導(dǎo)航欄距離頂部距離
    menuHeight: app.globalData.menuHeight //導(dǎo)航欄高度
  }

復(fù)制代碼

封裝成組件

我們可能在各自的頁(yè)面實(shí)現(xiàn)不一樣的效果,比如在導(dǎo)航欄添加搜索框,日期等,這個(gè)時(shí)候我們就可以封裝一個(gè)自定義組件,大大提高我們的開(kāi)發(fā)效率。

新建component

// components/navigation/index.wxml
<view class="nav" style="height:{{navBarHeight}}px;">
  <view class="nav-main">
    <!-- 膠囊區(qū)域 -->
    <view 
      class="capsule-box" 
      style="height:{{menuHeight}}px; min-height:{{menuHeight}}px; line-height:{{menuHeight}}px; bottom:{{menuBotton}}px;left:{{menuRight}}px;"
    >
    <!-- 導(dǎo)航內(nèi)容區(qū)域 -->
      <slot></slot>
    </view>
  </view>
</view>
復(fù)制代碼
// components/navigation/index.wxss
.nav {
  position: fixed;
  top: 0;
  left: 0;
  width: 100vw;
}
.nav-main {
  width: 100%;
  height: 100%;
  position: relative;
}
.nav .capsule-box {
  position: absolute;
  box-sizing: border-box;
  width: 100%;
}

復(fù)制代碼
// components/navigation/index.js
const app = getApp()
Component({
  /**
   * 組件的初始數(shù)據(jù)
   */
  data: {
    navBarHeight: app.globalData.navBarHeight, //導(dǎo)航欄高度
    menuRight: app.globalData.menuRight, // 膠囊距右方間距(方保持左、右間距一致)
    menuBotton: app.globalData.menuBotton,
    menuHeight: app.globalData.menuHeight
  }
})
復(fù)制代碼

頁(yè)面引用

頁(yè)面配置引入該自定義組件

//index.json
{
  "navigationStyle": "custom",
  "navigationBarTextStyle": "white",
  "usingComponents": {
    "navigation": "/components/Navigation/index"
  }
}
復(fù)制代碼

頁(yè)面中使用

<!-- 自定義導(dǎo)航 -->
<navigation>
  <view class="current-date">
     <text>4月24日</text>
  </view>
</navigation>
復(fù)制代碼

總結(jié)

本文主要是寫(xiě)自定義導(dǎo)航基礎(chǔ)的東西,重點(diǎn)在于怎么計(jì)算自定義導(dǎo)航的,具體的業(yè)務(wù)和樣式還需要根據(jù)自身產(chǎn)品來(lái)設(shè)定。如有什么問(wèn)題,歡迎提出一起學(xué)習(xí)。

 


易優(yōu)小程序(企業(yè)版)+靈活api+前后代碼開(kāi)源 碼云倉(cāng)庫(kù):starfork
本文地址:http://www.u-renovate.com/wxmini/doc/course/25174.html 復(fù)制鏈接 如需定制請(qǐng)聯(lián)系易優(yōu)客服咨詢(xún):800182392 點(diǎn)擊咨詢(xún)
QQ在線咨詢(xún)
AI智能客服 ×