评论

教你解决showLoading 和 showToast显示异常的问题

小程序官方规定,showLoading和showToast 同时只能显示一个,而且需要配对使用。需要开发者去解决原生toast和Loading相互覆盖的问题

问题描述

当wx.showLoading 和 wx.showToast 混合使用时,showLoading和showToast会相互覆盖对方,调用hideLoading时也会将toast内容进行隐藏。

触发场景

当我们给一个网络请求增加Loading态时,如果同时存在多个请求(A和B),如果A请求失败需要将错误信息以Toast形式展示,B请求完成后又调用了wx.hideLoading来结束Loading态,此时Toast也会立即消失,不符合展示一段时间后再隐藏的预期。

解决思路

这个问题的出现,其实是因为小程序将Toast和Loading放到同一层渲染引起的,而且缺乏一个优先级判断,也没有提供Toast、Loading是否正在显示的接口供业务侧判断。所以实现的方案是我们自己实现这套逻辑,可以使用Object.defineProperty方法重新定义原生API,业务使用方式不需要任何修改。

代码参考

// 注意此代码应该在调用原生api之前执行
let isShowLoading = false;
let isShowToast = false;
const {
  showLoading,
  hideLoading,
  showToast,
  hideToast
} = wx;
Object.defineProperty(wx, 'showLoading', {
  configurable: true, // 是否可以配置
  enumerable: true, // 是否可迭代
  writable: true, // 是否可重写
  value(...param) {
    if (isShowToast) { // Toast优先级更高
      return;
    }
    isShowLoading = true;
    console.log('--------showLoading--------')
    return showLoading.apply(this, param); // 原样移交函数参数和this
  }
});
Object.defineProperty(wx, 'hideLoading', {
  configurable: true, // 是否可以配置
  enumerable: true, // 是否可迭代
  writable: true, // 是否可重写
  value(...param) {
    if (isShowToast) { // Toast优先级更高
      return;
    }
    isShowLoading = false;
    console.log('--------hideLoading--------')
    return hideLoading.apply(this, param); // 原样移交函数参数和this
  }
});
Object.defineProperty(wx, 'showToast', {
  configurable: true, // 是否可以配置
  enumerable: true, // 是否可迭代
  writable: true, // 是否可重写
  value(...param) {
    if (isShowLoading) { // Toast优先级更高
      wx.hideLoading();
    }
    isShowToast = true;
    console.error('--------showToast--------')
    return showToast.apply(this, param); // 原样移交函数参数和this
  }
});
Object.defineProperty(wx, 'hideToast', {
  configurable: true, // 是否可以配置
  enumerable: true, // 是否可迭代
  writable: true, // 是否可重写
  value(...param) {
    isShowToast = false;
    console.error('--------hideToast--------')
    return hideToast.apply(this, param); // 原样移交函数参数和this
  }
});

调整后展示逻辑为:

  1. 优先级:Toast>Loading,如果Toast正在显示,调用showLoading、hideLoading将无效
  2. 调用showToast时,如果Loading正在显示,则先调用 wx.hideLoading 隐藏Loading
最后一次编辑于  2019-10-30  
点赞 25
收藏
评论

8 个评论

  • 余松
    余松
    2021-03-15

    showToast 之后没有显示调用hideToast的情况没有处理

    2021-03-15
    赞同 2
    回复 1
    • felicia_zh
      felicia_zh
      2023-02-14
      同样遇到这个问题,请问怎么处理呢?
      2023-02-14
      回复
  • 胡某
    胡某
    2021-09-24

    好文,赞一个

    2021-09-24
    赞同 1
    回复
  • 言葉
    言葉
    2023-05-15

    代码很好,可惜下一秒就是我的了

    2023-05-15
    赞同
    回复
  • 沉沉迷
    沉沉迷
    2022-07-26

    不懂。

    unapp或者原生小程序,这段代码应该放在什么位置?

    2022-07-26
    赞同
    回复 1
    • Naruto
      Naruto
      2023-12-28
      main.js
      2023-12-28
      1
      回复
  • Mr Yang
    Mr Yang
    2021-08-04

    好文,收藏

    2021-08-04
    赞同
    回复
  • /迷茫的人生/
    /迷茫的人生/
    2020-07-14

    点个赞,不错

    2020-07-14
    赞同
    回复
  • Lawson
    Lawson
    2020-03-05

    现在不支持修改属性,会报错呢

    2020-03-05
    赞同
    回复
  • 沫笺
    沫笺
    2019-12-27

    好棒呀,一直有这个问题,今天看到楼主大大这个文章,试了一下,果然可以~感谢楼主大大的干货分享~

    2019-12-27
    赞同
    回复 1
    • Terrance
      Terrance
      2019-12-27
      我之前也头疼这个问题,共勉~
      2019-12-27
      1
      回复
登录 后发表内容