小程序技能进阶回忆录 - 怎样让 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 再刷新重新请求接口。