阅读 1923

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

传送门

广告时间

美团单车事业部(摩拜单车)诚招前端 / 小程序研发工程师,位置北京,有兴趣可以发简历到 zhangshibing@mobike.com 或者扫二维码先加微信勾搭:)

关注下面的标签,发现更多相似文章
评论