uni-app小程序沉浸式導航實現的全過程

Posted on by

1. 開始

項目要在多個頁面上加自定義導航欄，還要有漸變效果，就是隨著頁面上滑，導航欄透明度由0逐漸變為1。這裡面有幾個基本點需要註意下。

2. page的樣式

page 不能是height: 100%，可以設置height: auto，這樣才可以觸發 onPageScroll。

3. onPageScroll

隻有 page 才有 onPageScroll 事件。試驗發現，mixin 和頁面內都寫瞭 onPageScroll 的話，都會觸發。

如果把它放在 mixin 中，寫成下面這樣，可能會有問題：

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

因為自定義導航欄不一定要在頁面級組件上，很多頁面都是寫在子組件裡，而 mixin 是各個組件各自維護瞭一份data，所以無法傳遞。這也是Vue組件和小程序組件的不同之處。

解決方法有多個：

  • 將 onPageScroll 寫在頁面級組件上，然後獲取到 scrollTop 後傳給子組件，這種方法太麻煩
  • onPageScroll 依然寫在 mixin 中，保存 scrollTop 到 vuex 的 state 中，然後在頁面或者組件中獲取這個 state

4. 性能問題

這裡面還有兩個性能相關的點要註意下：

  • 隻有頁面級組件或者個別組件需要用的數據，不要放在 mixin 的 data/computed 中。因為 mixin 是所有組件的混入，並且 uni-app 中所有 data 和 computed 都會作為渲染依賴（不管用沒用到），可能會引起很多性能開銷。
  • onPageScroll 中不要做復雜邏輯，不要頻繁調用 setData，在 uni-app 中就是不要頻繁更新 data。因為小程序是雙線程通信，邏輯層更改數據要先到 native層，再傳到渲染層，中間可能還有 JSON.stringify 等操作。

5. 方案

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

  • mixin中，監聽 onPageScroll，因為這個在隻會在當前頁面觸發，子組件會被忽略，所以寫在這裡並不影響性能。

  • vuex 中保存 pageScrollTop、mpHeaderHeight，及一個衍生變量 mpHeaderBg。

  • 然後，需要使用 mpHeaderBg 的頁面，去引用 vuex 中的變量。

  • 如果想要在一個新頁面加上漸變導航，隻需要引用 vuex 中的 mpHeaderBg 即可。

6. 代碼

// 某個頁面
<template>
  <MatchHeaderMp
    :header-bg="mpHeaderBg"
  />
</template>
<script>
computed: {
  mpHeaderBg() {
    // getMpHeaderBg 方法來自於 mixin
    return this.getMpHeaderBg();
  },
}
</script>
// mixin
export const uniSystemInfoMixin = {
  data() {
    return {
      // page-meta上設置的根標簽字體大小
      mixinRootFontSize: 50,
    };
  },
  mounted() {
    // 設置根字體大小
    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;

    // 如果滑動值大於 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 時（iphone6），rootFontSize為50，則一份為 375/50=7.5
      const screenNumber = 7.5;
      const that = this ;

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

        // 打開獲取屏幕大小
        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: () => ({
    // 存放多個頁面的pageScrollTop
    pageScrollTopMap: {},
    // 狀態欄高度
    mpHeaderHeight: 44,
  }),
  mutations: {
    setPageScrollTop(state, pageScrollTop = 0) {
      const curPageName = getCurPageName();
      state.pageScrollTopMap = {
        ...state.pageScrollTopMap,
        [curPageName]: pageScrollTop,
      };
    },
    setMpHeaderHeight(state, mpHeaderHeight) {
      state.mpHeaderHeight = mpHeaderHeight;
    },
  },
};

7. 註意事項

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

總結

到此這篇關於uni-app小程序沉浸式導航實現的文章就介紹到這瞭,更多相關uni-app小程序沉浸式導航內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet！

推薦閱讀：