《微信小程序开发》 页面导航最强详解 | 如何对小程序页面进行跳转?

Posted XianZhe_

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了《微信小程序开发》 页面导航最强详解 | 如何对小程序页面进行跳转?相关的知识,希望对你有一定的参考价值。

《微信小程序开发》 页面导航最强详解 | 如何对小程序页面进行跳转?

文章目录


一、微信小程序导航

小程序能够在不同的页面进行跳转切换,路由起到了至关重要的作用,所有页面的路由全部由小程序框架进行管理,要想开发好小程序,路由可谓是一门必修课。

在使用方面上区分,小程序的路由和Vue类似,分为 命名式导航编程式导航 两种,只不过路由的切换方式、传参方式等有所不同。同时微信小程序的导航跟 uni-app 十分相似,学会原生的微信小程序,相信对于使用 uni-app 是没有问题的。

在本文演示代码中,tabbar 页面配置如下, 其余页面均为非 tabbar 页面。

  "tabBar": 
    "list": [
      
        "pagePath": "pages/index/index",
        "text": "主页",
        "iconPath": "./image/homepage.png",
        "selectedIconPath": "./image/homepage-sel.png"
      ,
      
        "pagePath": "pages/about/index",
        "text": "关于",
        "iconPath": "./image/category.png",
        "selectedIconPath": "./image/category-sel.png"
      
    ]
  

本文包含的内容有:命名式导航,编程式导航,路由传参,页面栈。


二、命名式导航与编程式导航对应表

1、在开始讲解之前,我觉得有必要将此对应表先列出来:

  • ①这样有助于阅读后面的内容时能够回来查询弥补。
  • ②作为复习作用,在往后打开此文章能够一目了然的作为一个备忘表。
跳转方式(open-type)编程式对应To tabBar 页面说明最低版本
navigatewx.navigateTo保留当前页面,跳转到应用内的某个页面,但是不能跳到 tabbar 页面。兼容
redirectwx.redirectTo关闭当前页面,跳转到应用内的某个页面。但是不允许跳转到 tabbar 页面。兼容
switchTabwx.switchTab跳转到 tabBar 页面,并关闭其他所有非 tabBar 页面。兼容
reLaunchwx.reLaunch关闭所有页面,打开到应用内的某个页面。1.1.0
navigateBackwx.navigateBack不能在 tabBar 页面中使用❗关闭当前页面,返回上一页面或多级页面。1.1.0
exitwx.exitMiniProgram退出小程序,target="miniProgram"时生效2.1.0

2、一些管理路由Api:

  • getCurrentPages(): 获取当前页面栈。数组中第一个元素为首页,最后一个元素为当前页面。小程序中页面栈最多十层。
    showPages() 
      console.log(getCurrentPages());
    
    // -> [Ra]
    
  • Router对象: 页面路由器对象。可以通过 this.pageRouterthis.router 获得当前页面或自定义组件的路由器对象。
    页面路由器有switchTabreLaunchredirectTonavigateTonavigateBack 五个方法,与 wx 对象向同名的五个方法 switchTabreLaunchredirectTonavigateTonavigateBack 功能相同。不同的是,使用Router对象进行页面跳转,相对路径永远相对于 this 指代的页面或自定义组件。
    showRout() 
     console.log(this.pageRouter);
     console.log(this.router);
     // -> true
     console.log(this.pageRouter === this.router);
    
    

三、命名式导航🥇

1、基本语法

使用 navigator 组件进行跳转,可以理解成 html 中的 <a/> 标签。url 属性填入路由地址,更改 open-type 属性实现不同的跳转方式。

<navigator open-type="switchTab" url="../index/index">主页</navigator>

可以配合 button 组件进行使用

<navigator open-type="switchTab" url="../index/index">
    <button type="primary" class="btn">主页</button>
</navigator>

2、navigate 跳转方式

保留当前页面,跳转到应用内的某个页面,但是不能跳到 tabbar 页面,一般用来跳转到详情页、支付页等。

保留当前页面就是在页面栈中保留了上一页面指向,注意观察下方图示,页面栈从数量1变成了2。

<navigator open-type="navigate" url="../detail/index">
  <button type="primary" class="btn">navigate / 跳转到详情页</button>
</navigator>
跳转前跳转后

倘若非要跳转到 tabbar 页面,那么点击之后是没有效果的。

3、redirect 跳转方式

关闭当前页面,跳转到应用内的某个页面。 但是不允许跳转到 tabbar 页面。

注意观察下方图示,可以发现两点:

  • 对比 navigate 跳转方式,使用 redirect 跳转方式后页面栈数为1,始终指向当前页面。
  • 在详情页中,左上角不再是回退按钮,更改为了主页按钮,证明跳转前的页面已被关闭,页面栈中已移除。
<navigator open-type="redirect" url="../detail/index">
  <button type="primary" class="btn">redirect / 跳转到详情页</button>
</navigator>
跳转前跳转后

但实际上 redirect 是可以跳转到 tabbar 页面,但会给页面栈造成意料之外的影响

打印出跳转前和跳转后的页面栈,看看两者之间的区别:

  • 可以看到跳转之后的页面栈数并未发生改变,但透过页面栈元素的route 属性可以发现,详情页其实已经被删除。相对的,页面栈居然存在多个同样的 tarBar 页面。
  • 带着这个意料之外的页面栈,再次来到详情页,跳转回到主页时,抛出Expected updated data but get first rendering data 异常,且页面栈元素被重置。

鉴于对页面栈的影响,且官方并不推荐使用,所以伙伴们还是别用这个方式跳转到tabbar页面为妙。

<navigator open-type="redirect" url="../index/index">
  <button type="warn" class="btn">redirect / 主页</button>
</navigator>
跳转前跳转后

4、switchTab 跳转方式

跳转到 tabBar 页面,使用此跳转方式会关闭其他所有非 tabBar 页面。

在下面的示例图中,使用后switchTab 跳转方式跳转后,页面栈中只剩下当前页面元素。

<navigator open-type="switchTab" url="../index/index">
  <button type="primary" class="btn">switchTab / 主页</button>
</navigator>
跳转前跳转后

5、reLaunch 跳转方式

关闭所有页面,打开到应用内的某个页面。

就用法而已,reLaunch 跳转方式与 switchTab 跳转方式类似,不同的在于switchTab 是专门为 tabBar 页面设计的,只能跳转到 tabBar 页面,而 reLaunch 跳转到哪都行。

<navigator open-type="reLaunch" url="../other/index">
  <button plain class="btn">reLaunch/跳转到其他页面</button>
</navigator>
跳转前跳转后

6、navigateBack 跳转方式

关闭当前页面,返回上一页面或多级页面,需要配合 delta 属性进行使用。

使用 navigateBack 时,需要注意以下几点:

  • 页面栈最多十层,也就是说最多能返回九级页面,注意把握页面栈大小。
  • 如果 delta 大于已有页面数,则跳转到栈中的第一个页面(首页)。
  • navigateBack 不能在 tabbar 页面中使用,会不起作用。
<navigator open-type="navigateBack" delta="1">
  <button type="warn" plain class="btn">回到上一级 d1</button>
</navigator>
<navigator open-type="navigateBack" delta="2">
  <button type="warn" plain class="btn">回到上一级 d2</button>
</navigator>
<navigator open-type="navigateBack" delta="10">
  <button type="warn" plain class="btn">回到上一级 d10</button>
</navigator>
跳转前跳转后

7、exit 退出小程序

exit 只能在手机上才有效果,开发者工具上是没用的,要注意将 target 设为miniProgram。

<navigator open-type="exit" target="miniProgram">
  <button type="warn" plain class="btn">退出小程序</button>
</navigator>

四、编程式导航🏆

与声明式导航不同的是,编程式导航主要是靠JS代码实现,调用 wx. Api 进行跳转,其作用和声明式导航是一样的。
关于每个不同跳转方式的区别,在 三、命名式导航 中已经充分的讲解,这里不过多叙述,只演示写法。

声明式导航和编程式导航只是写法不同,同时编程式的写法大同小异,下面的演示重复性会很高,已经知道写法的伙伴们可以跳着看。

1、wx.navigateTo

保留当前页面,跳转到应用内的某个页面,但是不能跳到 tabbar 页面,一般用来跳转到详情页、支付页等。

<button type="primary" style="margin-top: 30rpx;" class="btn" bindtap="toDetailEvent">navigate / 跳转到详情页</button>
async toDetailEvent() 
  wx.navigateTo(
    // 需要跳转的应用内非 tabBar 的页面的路径
    url: '/pages/detail/index',
    // 接口调用成功的回调函数
    success: (res) => ,
    // 接口调用失败的回调函数
    fail: (res) => ,
    // 接口调用结束的回调函数(调用成功、失败都会执行)
    complete: (res) => ,
  )
,
跳转前跳转后

2、wx.redirectTo

关闭当前页面,跳转到应用内的某个页面。 但是不允许跳转到 tabbar 页面。

<button type="primary" class="btn" bindtap="toDetailByRedirectEvent">redirect / 跳转到详情页</button>
async toDetailByRedirectEvent() 
  wx.redirectTo(
    // 需要跳转的应用内非 tabBar 的页面的路径
    url: '/pages/detail/index',
    // 接口调用成功的回调函数
    success: (res) => ,
    // 接口调用失败的回调函数
    fail: (res) => ,
    // 接口调用结束的回调函数(调用成功、失败都会执行)
    complete: (res) => ,
  )
,
跳转前跳转后

3、wx.switchTab

跳转到 tabBar 页面,并关闭其他所有非 tabBar 页面。

<button type="primary" class="btn" bindtap="toIndexByswitchTabEvent">switchTab / 主页</button>
async toIndexByswitchTabEvent() 
  wx.switchTab(
    // 需要跳转的 tabBar 页面的路径
    url: '/pages/index/index',
    // 接口调用成功的回调函数
    success: (res) => ,
    // 接口调用失败的回调函数
    fail: (res) => ,
    // 接口调用结束的回调函数(调用成功、失败都会执行)
    complete: (res) => ,
  )
,
跳转前跳转后

4、wx.reLaunch

关闭所有页面,打开到应用内的某个页面。

<button plain class="btn" bindtap="toOtherByreLaunchEvent">reLaunch/跳转到其他页面</button>
async toOtherByreLaunchEvent() 
  wx.reLaunch(
    // 关闭所有页面,打开到应用内的某个页面
    url: "/pages/other/index",
    // 接口调用成功的回调函数
    success: (res) => ,
    // 接口调用失败的回调函数
    fail: (res) => ,
    // 接口调用结束的回调函数(调用成功、失败都会执行)
    complete: (res) => ,
  );
,

5、wx.navigateBack

关闭当前页面,返回上一页面或多级页面。

<button type="warn" plain class="btn" bindtap="navigateBackEvent">回到上一级 d1</button>
async navigateBackEvent() 
  wx.navigateBack(
    // 返回的页面数,如果 delta 大于现有页面数,则返回到首页。
    delta: 1,
    // 接口调用成功的回调函数
    success: (res) => ,
    // 接口调用失败的回调函数
    fail: (res) => ,
    // 接口调用结束的回调函数(调用成功、失败都会执行)
    complete: (res) => ,
  );
,

6、wx.exitMiniProgram

退出当前小程序。

使用编程式退出有个好处,能够在退出之前做一些收尾操作,如清除缓存、关闭程序任务等。

<button type="warn" plain class="btn" bindtap="exitMiniProgram">退出小程序</button>
exitMiniProgram() 
  wx.exitMiniProgram(
    // 接口调用成功的回调函数
    success: (res) => 
      // 以同步的方式清理本地数据缓存
      wx.clearStorageSync();
      console.log("缓存清理成功");
    ,
    // 接口调用失败的回调函数
    fail: (res) => ,
    // 接口调用结束的回调函数(调用成功、失败都会执行)
    complete: (res) => ,
  );
,

五、路由传参

页面跳转的时候还支持传参,只需要在路径后加上参数即可,写法与HTTP GET请求一样。参数与路径之间使用 ? 分隔,参数键与参数值用 = 相连,不同参数用 & 分隔;如 ‘path?key=value&key2=value2’。

传入的参数在页面生命周期 onLoad(options) 方法中的 options 参数以对象的形式接收。

注意,并不是所有跳转方式都支持传参。

跳转方式支持传参
navigate
redirect
switchTab
reLaunch
navigateBack
exit

演示代码 👇

  <text>路由传参</text>
  <view class="btns params-list">
    <view class="params-item">
      <label>
        <text>Key:</text>
        <input class="inp-key" bindinput="inputEvent" data-id="k1"></input>
      </label>
      <label>
        <text>value:</text>
        <input class="inp-value" bindinput="inputEvent" data-id="v1"></input>
      </label>
    </view>
    <view class="params-item">
      <label>
        <text>Key:</text>
        <input class="inp-key" bindinput="inputEvent" data-id="k2"></input>
      </label>
      <label>
        以上是关于《微信小程序开发》 页面导航最强详解 | 如何对小程序页面进行跳转?的主要内容,如果未能解决你的问题,请参考以下文章

《微信小程序开发》 页面导航最强详解 | 如何对小程序页面进行跳转?

微信小程序开发—小程序框架详解

微信小程序开发共工具怎么倒入源码

微信小程序开发,导航栏右边的按钮怎么设置

微信小程序开发注意事项重点都有哪些

微信小程序开发常用知识点