相信只要开发过小程序,对wx.navigateBack 这个 api都不会陌生。在摩拜单车的小程序中,它也被改造的更方便满足复杂的业务需求,可谓之 增强型的 wx.navigateBack。
先来看看官方文档中的用法:
wx.navigateBack({ delta: 2 })
delta 表示返回的层级数。通过具体的业务示例来说明我们如何改造它:
余额充值的例子
两个页面:
用户在 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 页面。
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) }
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 再刷新重新请求接口。‘