小程序技能進階回憶錄 - 怎樣讓 wx.navigateBack 更好用

即便是戰爭，也要像西伯利亞風雪中挺拔的白樺，出落得亭亭玉立，楚楚動人。

相信只要開發太小程序，對wx.navigateBack 這個 api都不會陌生。在摩拜單車的小程序中，它也被改造的更方便知足複雜的業務需求，可謂之 加強型的 wx.navigateBack。

先來看看官方文檔中的用法：

wx.navigateBack({
  delta: 2
})

delta 表示返回的層級數。經過具體的業務示例來講明咱們如何改造它：

餘額充值的例子

兩個頁面：

• A 頁面展現用戶餘額，使用 H5 實現，經過 web-view 嵌套在小程序裏
• B 頁面爲用戶充值，爲了方便使用支付api，用小程序原生頁面實現

用戶在 B 頁面充值完成後返回頁面 A，更新用戶餘額。翻譯成技術語言就是：從小程序原生頁面返回到 H5 頁面，須要刷新。

簡單的業務代碼以下：

<!-- pages/balance/index.wxml -->
<web-view src="{{url}}"></web-view>

Page({
  data: {
    url: 'https://balance/url'
  },
  onShow() {
    // ...
  },
  onHide() {
    // ...
  }
})

只要再次進入 A 頁面更新 URL，就能達到刷新的目的。能夠每次動態加參數，也能夠離開 A 時清空 URL，再次進入的時候還原回來：

const URL = 'https://balance/url'
Page({
  data: {
    url: URL
  },
  onShow() {
    this.setData({
      url: URL
    })
  },
  onHide() {
    setTimeout(() => {
      this.setData({
        url: ''
      })
    }, 800)
  }
})

爲了避免讓屏幕忽然變白，加了 setTimeout 延遲下。

選擇性的返回刷新

上面雖然實現了需求，可是有個體驗問題：無論用戶充值與否，回到 A 頁面都會刷新下。理論上，只有用戶充值成功後才須要刷新 A 頁面。

簡單看下 B 頁面的代碼：

Page({
  data: {},
  onTopup() {
    wx.requestPayment({
      // ...
      success(res) {
        wx.navigateBack()
      }
    })
  }
})

能否在返回 A 的時候告訴 A 是否充值成功？這樣 A 就能選擇性的刷新。

const URL = 'https://balance/url'
Page({
  data: {
    url: URL,
    isPaySuccess: false
  },
  onShow() {
    if (this.data.isPaySuccess) {
      this.setData({
        url: URL + '?refresh=1'
      })
    }
  }
})

A 頁面有個 isPaySuccess 標記位控制是否刷新，那麼如何在 B 頁面支付成功後去修改這個標記位？直接看 B 頁面的代碼：

Page({
  data: {},
  onTopup() {
    wx.requestPayment({
      // ...
      success(res) {
        let pages = getCurrentPages()
        let pageA = pages[pages.length - 2]
        pageA.setData({
          isPaySuccess: true
        })
        wx.navigateBack()
      }
    })
  }
})

封裝成 this.$back

能夠封裝成通用的 back 方法，返回頁面的同時更改其數據：

function back(config) {
  let prevPageData = config.prevPageData
  let delta = config.delta || 1
  if (prevPageData) {
    let pages = getCurrentPages()
    let prevPage = pages[pages.length - (delta + 1)]
    prevPage.setData(config.prevPageData)
  }
  wx.navigateBack(config)
}

經過這樣封裝，上面的頁面 B 的代碼能夠改爲這樣：

let back = require('../utils/back')
Page({
  data: {},
  onTopup() {
    wx.requestPayment({
      // ...
      success(res) {
        back({
          prevPageData: {
            isPaySuccess: true
          }
        })
      }
    })
  }
})

若是看過 globalData 的那些事兒，把 back 方法掛載到 this.$back 下，將會更方便使用：

Page({
  data: {},
  onTopup() {
    wx.requestPayment({
      // ...
      success(res) {
        this.$back({
          prevPageData: {
            isPaySuccess: true
          }
        })
      }
    })
  }
})

總結

簡單的 api 也能夠變得豐富，一切都是基於日益複雜的業務需求。經過加強 wx.navigateBack 不單單能夠改變前一個頁面的標記位，還能夠改變其頁面顯示數據。好比頁面 A 的餘額值是小程序經過參數傳給 H5 的，而頁面 B 充值成功後接口返回用戶新的餘額。這樣就能夠在充值成功後直接改變頁面 A 的餘額數據，而不是先返回到頁面 A 再刷新從新請求接口。