快捷導(dǎo)航

uni-app小程序沉浸式導(dǎo)航實(shí)現(xiàn)的全過(guò)程

更新時(shí)間：2022年10月08日 16:25:05 作者：Novlan1

在跨端項(xiàng)目開(kāi)發(fā)中,uniapp是個(gè)不錯(cuò)的框架,下面這篇文章主要給大家介紹了關(guān)于uni-app小程序沉浸式導(dǎo)航實(shí)現(xiàn)的相關(guān)資料,文中通過(guò)實(shí)例代碼介紹的非常詳細(xì),需要的朋友可以參考下

1. 開(kāi)始

項(xiàng)目要在多個(gè)頁(yè)面上加自定義導(dǎo)航欄，還要有漸變效果，就是隨著頁(yè)面上滑，導(dǎo)航欄透明度由0逐漸變?yōu)?。這里面有幾個(gè)基本點(diǎn)需要注意下。

2. page的樣式

page 不能是height: 100%，可以設(shè)置height: auto，這樣才可以觸發(fā) onPageScroll。

3. onPageScroll

只有 page 才有 onPageScroll 事件。試驗(yàn)發(fā)現(xiàn)，mixin 和頁(yè)面內(nèi)都寫(xiě)了 onPageScroll 的話，都會(huì)觸發(fā)。

如果把它放在 mixin 中，寫(xiě)成下面這樣，可能會(huì)有問(wèn)題：

data() {
  return {
    pageScrollTop: 0,
  };
},
onPageScroll({ scrollTop }) {
  this.pageScrollTop = scrollTop || 0;
},

因?yàn)樽远x導(dǎo)航欄不一定要在頁(yè)面級(jí)組件上，很多頁(yè)面都是寫(xiě)在子組件里，而 mixin 是各個(gè)組件各自維護(hù)了一份data，所以無(wú)法傳遞。這也是Vue組件和小程序組件的不同之處。

解決方法有多個(gè)：

將 onPageScroll 寫(xiě)在頁(yè)面級(jí)組件上，然后獲取到 scrollTop 后傳給子組件，這種方法太麻煩
onPageScroll 依然寫(xiě)在 mixin 中，保存 scrollTop 到 vuex 的 state 中，然后在頁(yè)面或者組件中獲取這個(gè) state

4. 性能問(wèn)題

這里面還有兩個(gè)性能相關(guān)的點(diǎn)要注意下：

只有頁(yè)面級(jí)組件或者個(gè)別組件需要用的數(shù)據(jù)，不要放在 mixin 的 data/computed 中。因?yàn)?mixin 是所有組件的混入，并且 uni-app 中所有 data 和 computed 都會(huì)作為渲染依賴（不管用沒(méi)用到），可能會(huì)引起很多性能開(kāi)銷。
onPageScroll 中不要做復(fù)雜邏輯，不要頻繁調(diào)用 setData，在 uni-app 中就是不要頻繁更新 data。因?yàn)樾〕绦蚴请p線程通信，邏輯層更改數(shù)據(jù)要先到 native層，再傳到渲染層，中間可能還有 JSON.stringify 等操作。

5. 方案

綜上，目前采用的方案是：

mixin中，監(jiān)聽(tīng) onPageScroll，因?yàn)檫@個(gè)在只會(huì)在當(dāng)前頁(yè)面觸發(fā)，子組件會(huì)被忽略，所以寫(xiě)在這里并不影響性能。
vuex 中保存 pageScrollTop、mpHeaderHeight，及一個(gè)衍生變量 mpHeaderBg。
然后，需要使用 mpHeaderBg 的頁(yè)面，去引用 vuex 中的變量。
如果想要在一個(gè)新頁(yè)面加上漸變導(dǎo)航，只需要引用 vuex 中的 mpHeaderBg 即可。

6. 代碼

// 某個(gè)頁(yè)面
<template>
  <MatchHeaderMp
    :header-bg="mpHeaderBg"
  />
</template>
<script>
computed: {
  mpHeaderBg() {
    // getMpHeaderBg 方法來(lái)自于 mixin
    return this.getMpHeaderBg();
  },
}
</script>

// mixin
export const uniSystemInfoMixin = {
  data() {
    return {
      // page-meta上設(shè)置的根標(biāo)簽字體大小
      mixinRootFontSize: 50,
    };
  },
  mounted() {
    // 設(shè)置根字體大小
    this.onSetFontSize();
  },
  onPageScroll({ scrollTop }) {
    const mpHeaderHeight = this.$store.state.wxHeader.mpHeaderHeight || 44;
    const pageScrollTop =  this.$store.getters.['wxHeader/pageScrollTop'] || 44;
    const parsedScrollTop = scrollTop > mpHeaderHeight ? mpHeaderHeight : scrollTop;

    // 如果滑動(dòng)值大于 mpHeaderHeight，就不再更新 data
    if (parsedScrollTop === mpHeaderHeight && pageScrollTop === mpHeaderHeight) {
      return;
    }
    this.$store.commit('wxHeader/setPageScrollTop', parsedScrollTop);
  },
  beforeDestroy() {
    if (this.mpType === 'page') {
      this.$store.commit('wxHeader/setPageScrollTop', 0);
    }
  },
  methods: {
    getMpHeaderBg() {
      const pageScrollTop = this.getMpPageScrollTop();
      const mpHeaderHeight = this.$store.state.wxHeader.mpHeaderHeight || 44;
      return `rgba(255, 255, 255, ${Math.min(1, pageScrollTop / mpHeaderHeight)})`;
    },
    getMpPageScrollTop() {
      const curPageName = this.getCurPageName();
      const pageScrollTopMap = this.$store.state.wxHeader.pageScrollTopMap || {};
      return pageScrollTopMap[curPageName] || 0;
    },
    getCurPageName() {
      const pages = getCurrentPages();
      return pages[pages.length - 1].route;
    },
    onSetFontSize() {
      // 寬度 375 時(shí)（iphone6），rootFontSize為50，則一份為 375/50=7.5
      const screenNumber = 7.5;
      const that = this ;

      if (that.mpType === 'page') {
        // 窗體改變大小觸發(fā)事件
        uni.onWindowResize((res) => {
          if (res.size.windowWidth) {
            that.mixinRootFontSize = parseFloat(res.size.windowWidth) / screenNumber;
          }
        });

        // 打開(kāi)獲取屏幕大小
        uni.getSystemInfo({
          success(res) {
            const fontsize = res.screenWidth / screenNumber;
            that.mixinRootFontSize = fontsize;
            const mpHeaderHeight = res.statusBarHeight + 44;
            that.$store.commit('wxHeader/setMpHeaderHeight', mpHeaderHeight);
          },
        });
    }
    },
  },
};

// store/modules/wx-header.js
const wxHeaderStore = {
  namespaced: true,
  state: () => ({
    // 存放多個(gè)頁(yè)面的pageScrollTop
    pageScrollTopMap: {},
    // 狀態(tài)欄高度
    mpHeaderHeight: 44,
  }),
  mutations: {
    setPageScrollTop(state, pageScrollTop = 0) {
      const curPageName = getCurPageName();
      state.pageScrollTopMap = {
        ...state.pageScrollTopMap,
        [curPageName]: pageScrollTop,
      };
    },
    setMpHeaderHeight(state, mpHeaderHeight) {
      state.mpHeaderHeight = mpHeaderHeight;
    },
  },
};

7. 注意事項(xiàng)

不要多個(gè)頁(yè)面共享同一個(gè)變量，會(huì)存在多個(gè)頁(yè)面互相影響的可能。
小程序重新進(jìn)入某個(gè)頁(yè)面，都會(huì)重新回到頂部，包括page和所有scroll view，所以要在beforeDestroy中重置pageScrollTop。