微信小程序页面5层限制的一种解决方案

一、背景     很多开发者在面对小程序的五层页面限制时，内心大概是崩溃的。使用wx.navigateTo()或<navigator>组件(open-type=navigate时）跳转的页面路劲最多只有5层，这些页面路径可以通过wx.navigateBack() API或者左上角返回按钮顺序返回。当页面路径大于5层时，使用wx.navigateTo()跳转下一页不会有任何动静，页面既不跳转也不会报错（这就尴尬了，如果没有细看开发文档，还以为是自己代码写错了呢）。[注：开发工具和ios都不会报错，没有验证android的表现]但是，有时候业务场景存在多页面交互的情况，远远不止5层页面，这时候如何轻松处理页面跳转就成了一个不得不考虑的问题。    二、页面栈&小程序导航API接口微信小程序中的页面导航API有3个：wx.navigateTo、wx.redirectTo、wx.navigateBack。wx.navigateTo和wx.redirectTo打开新的页面，wx.navigateBack用于返回上一个页面（栈里的页面）。  这3个页面API的区别在于：navigateTo 不会将旧页面出栈；redirectTo 会将旧页面出栈，再将需要跳转到的页面入栈；navigateBack 则是将页面栈最后一个元素出栈，因此倒数第二个元素会成为最后一个元素，即变成「当前页面」。   1、wx.navigateTo接口与页面栈示意图当栈满了（5层）之后，再调用wx.navigateTo()跳转任何页面，都不会成功。特别注意的是，调用两次wx.navigateTo(‘页面B’);wx.navigateTo(‘页面B’);，那么栈里存在两个页面B（或者说两个页面B的实例），如下图。2、wx.redirectTo接口与页面栈示意图3、wx.navigateBack这个比较容易理解，就是栈里的页面一个一个出栈。当最后一个页面（首页A）出栈后，也就退出了小程序。在新版库中，给wx.navigateBack添加了一个参数delta，用于决定需要返回几层页面；如果delta大于等于现有页面数（也就是栈里的页面数），则返回到首页。4、页面栈与wx.navigateBack在此突出wx.navigateBack(OBJECT)和getCurrentPages()接口，因为本文提出的应对页面栈5层限制的方案正是充分利用这两个接口的结果。三、一种可以解决问题的方案由以上的对导航接口和页面栈的分析可以知道两点：（1）调用两次wx.navigateTo(‘页面B’)，那么栈里存在两个页面B（或者说两个页面B的实例）。但其实栈里没有必要保留两个页面B实例（2）wx.navigateBack的参数delta可以返回栈里的指定页面，其中页面信息可以由getCurrentPages()接口得到 据此，提出如下一种解决方案（1）自定义页面跳转方式（2）当页面栈里已经存在要跳转的目标页面A，那么使用wx.navigateBack({delta: xx})返回到此页面A，{xx=getCurrentPages().length – 目标页面A在栈里的index – 1}（3）如果页面栈还没有要跳转的目标页面A        a、若页面栈已经已满（length>=5），那么使用wx.redirectTo(页面A);        b、否则，使用wx.navigateTo(页面A)（4）页面间数据采用缓存传递 2、方案的实现/** desc:*  1、如果目标页面已经在栈中，那么wx.navigateBack({delta: xx})到目标页面*  2、如果目标页面不在栈中，*    （1）如果栈大小<5，那么wx.navigateTo(目标页面)*    （2）否则，wx.redirectTo(目标页面)*  3、所有页面间的数据传输，通过缓存携带*  4、跳转目标页，用goPage()*  5、在目标页，通过inPage()接收数据。接收后，数据会被删除*/Nav = {    MAX_VALUE: 5, //页面栈最多5层    /*     * desc: 跳转页面     * param:     *  obj: {     *    url: ”  //页面在app.json中的路径，路径前不要加’/’斜杠（也可以加，做了兼容）     *    data: {}  //需要携带的参数，统一通过缓存携带     *  }     */    goPage: function(obj) {        var pages = getCurrentPages(),  //页面栈            len = pages.length,            dlt = ”,            target = ‘/’ + obj.url.replace(/^//, ”), //如果有，将第一个‘/’去掉，然后再补上（开发者习惯不同，有些人会给url加/，有些则忘了，兼容处理            navigation_key = target.replace(///g, ‘_’); //存储数据的下标，每个页面由自己的存储key，保证了页面间数据不会相互污染        //查找目标页在页面栈的位置        for (var i = 0; i < len; i++) {            if (pages[i].route == target) { //                dlt = i + 1; //目标页在栈中的位置                break;            }        }        //保存数据        //由于navigateBack()回到指定页面，不会重新执行onLoad事件，所以加个标兵。        //只有在isLoad = true;时，才会接收参数并执行类onLoad事件        var nData = Object.assign({ referer: pages[len – 1].route, _is_load: true }, obj.data || {});        wx.setStorageSync(navigation_key, JSON.stringify(nData));        if (!dlt) { //页面不在栈中            if (len < this.MAX_VALUE) {                wx.navigateTo({                    url: target                });            } else {                wx.redirectTo({                    url: target                });            }        } else {            wx.navigateBack({                delta: len – dlt            });        }    },    /*     * desc：在目标页接收数据     * param：     *    myOnLoad：回调方法，由于通过缓存传递数据，页面onLoad没办法接收，所以要自定义回调     */    inPage: function(myOnLoad) {        var pages = getCurrentPages();        var navigation_key = pages[pages.length – 1].route.replace(///g, ‘_’);        //从其他页面跳转过来的，那么isLoad肯定为true，因为goPage中设置了。如果是用户点击左上角后退的，那么isLoad=false，因为下面设置了        //获取数据        try {            var raw = wx.getStorageSync(navigation_key);            var options = JSON.parse(raw);            if(options._is_load && myOnLoad) {  //用户点击左上角后退时，不会执行myOnLoad，因为此时_is_load是undefined              myOnLoad(options);            }            wx.setStorage({ //清除数据                key: navigation_key,                data: ”  //这之后，_is_load是undefined了            });        } catch (e) {                    }    }};采用以上方案后，就可以专心写代码逻辑了，不需要再担心页面层级无意间超过5层导致无法跳转的问题。 四、最完美的解决方案以上方案是完美的吗？想想，如果经过多次（超过5次）跳转，然后点击左上角后退会出现什么情况？是不是中间经过的一些页面不见了（早已经出栈了）。用户一般的预期是，我点击跳转多次，后退应该原路返回，即从哪里来的回到哪里去&怎么走过来的就怎么走回去。但这个问题显然是无法解决的，因为，一旦页面超过了5层，总有页面得出栈，“原路返回”已经失去了条件。其实，对于页面5层限制的问题，官方文档已经给出了完美的解决方案：