微信小程序详解——页面之间的跳转方式【路由】和参数传递

微信小程序拥有web网页和Application共同的特征,咱们的页面都不是孤立存在的,而是经过和其余页面进行交互,来共同完成系统的功能。今天咱们来研究小程序页面之间的跳转方式。android

1.先导

Android中,咱们Activity和Fragment都有栈的概念在里面,微信小程序页面也有栈的概念在里面。微信小程序页面跳转有四种方式: web

1.wx.navigateTo(OBJECT); 
2.wx.redirectTo(OBJECT); 
3.wx.switchTab(OBJECT); 
4.wx.navigateBack(OBJECT) 
5.使用实现对应的跳转功能;

分析:json

  1. 其中navigateTo是将原来的页面保存在页面栈中,在跳入到下一个页面的时候目标页面也进栈,只有在这个状况下点击手机的返回按钮才能够跳转到上一个页面;
  2. redirectTo和switchTab都是先清除栈中原来的页面,而后目标页面进栈,使用这两种跳转方式,都不能经过系统的返回键回到上一个页面,而是直接退出小程序;
  3. redirectTo使用的时候必定要配合tabBar或是页面里面能够再次跳转按钮,不然没法回到上一个页面;
  4. switchTab跳转的页面必须是tabBar中声明的页面;
  5. tabBar中定义的字段不能超过5个页面,小程序的页面栈层次也不能超过5层。
  6. navigateBack只能返回到页面栈中的指定页面,通常和navigateTo配合使用。
  7. wx.navigateTo 和 wx.redirectTo 不容许跳转到 tabbar 页面,只能用 wx.switchTab 跳转到 tabbar 页面

2.页面跳转的具体操做

(1)wx.navigateTo(OBJECT)

保留当前页面,跳转到应用内的某个页面,使用wx.navigateBack能够返回到原页面。小程序

OBJECT 参数说明:微信小程序

参数 类型 必填 说明
url String 须要跳转的应用内非 tabBar 的页面的路径 , 路径后能够带参数。参数与路径之间使用?分隔,参数键与参数值用=相连,不一样参数用&分隔;如 ‘path?key=value&key2=value2’
success Function 接口调用成功的回调函数
fail Function 接口调用失败的回调函数
complete Function 接口调用结束的回调函数(调用成功、失败都会执行)

示例代码:微信

wx.navigateTo({
  url: 'test?id=1'//实际路径要写全
})
//test.js
Page({
  onLoad: function(option){
    console.log(option.query)  
  }
})

注意:为了避免让用户在使用小程序时形成困扰,咱们规定页面路径只能是五层,请尽可能避免多层级的交互方式。微信开发

(2)wx.redirectTo(OBJECT)

关闭当前页面,跳转到应用内的某个页面。 
OBJECT 参数说明:app

参数 类型 必填 说明
url String 须要跳转的应用内非 tabBar 的页面的路径,路径后能够带参数。参数与路径之间使用?分隔,参数键与参数值用=相连,不一样参数用&分隔;如 ‘path?key=value&key2=value2’
success Function 接口调用成功的回调函数
fail Function 接口调用失败的回调函数
complete Function 接口调用结束的回调函数(调用成功、失败都会执行)

示例代码:框架

wx.redirectTo({
  url: 'test?id=1'
})

(3)wx.switchTab(OBJECT)

跳转到 tabBar 页面,并关闭其余全部非 tabBar 页面ide

OBJECT 参数说明:

参数 类型 必填 说明
url String 须要跳转的 tabBar 页面的路径(需在 app.json 的 tabBar 字段定义的页面),路径后不能带参数
success Function 接口调用成功的回调函数
fail Function 接口调用失败的回调函数
complete Function 接口调用结束的回调函数(调用成功、失败都会执行)

示例代码:

{
  "tabBar": {
    "list": [{
      "pagePath": "index",
      "text": "首页"
    },{
      "pagePath": "other",
      "text": "其余"
    }]
  }
}
wx.switchTab({
  url: '/index'
})

(4)wx.navigateBack(OBJECT)

关闭当前页面,返回上一页面或多级页面。可经过 getCurrentPages()) 获取当前的页面栈,决定须要返回几层。

OBJECT 参数说明:

参数 类型 必填 说明
delta Number 1 返回的页面数,若是 delta 大于现有页面数,则返回到首页。

示例代码:

// 注意:调用 navigateTo 跳转时,调用该方法的页面会被加入堆栈,而 redirectTo 方法则不会。见下方示例代码

// 此处是A页面
wx.navigateTo({
  url: 'B?id=1'
})
// 此处是B页面
wx.navigateTo({
  url: 'C?id=1'
})
// 在C页面内 navigateBack,将返回A页面
wx.navigateBack({
  delta: 2
})

(5)使用<navigator/>标签实现页面跳转

navigator

页面连接。

参数 类型 必填 说明
url String   应用内的跳转连接
redirect Boolean false 打开方式为页面重定向,对应 wx.redirectTo(将被废弃,推荐使用 open-type)
open-type String navigate 可选值 ‘navigate’、’redirect’、’switchTab’,对应于wx.navigateTo、wx.redirectTo、wx.switchTab的功能
hover-class String navigator-hover 指定点击时的样式类,当hover-class=”none”时,没有点击态效果
hover-start-time Number 50 按住后多久出现点击态,单位毫秒
hover-stay-time Number 600 手指松开后点击态保留时间,单位毫秒

示例代码:

<navigator url="navigate?title=navigate" hover-class="navigator-hover">跳转到新页面</navigator>
  <navigator url="redirect?title=redirect" open-type="redirect" hover-class="other-navigator-hover">在当前页打开</navigator>
  <navigator url="index" open-type="switchTab" hover-class="other-navigator-hover">切换 Tab</navigator>

3.页面的路由和生命周期

(1)页面的路由

在小程序中全部页面的路由所有由框架进行管理,对于路由的触发方式以及页面生命周期函数以下:

路由方式 触发时机 路由后页面 路由前页面
初始化 小程序打开的第一个页面 onLoad,onShow  
打开新页面 调用 API wx.navigateTo 或使用组件 onLoad,onShow onHide
页面重定向 调用 API wx.redirectTo 或使用组件 onLoad,onShow onUnload
页面返回 调用 API wx.navigateBack 或用户按左上角返回按钮 onShow onUnload(多层页面返回每一个页面都会按顺序触发onUnload)
Tab 切换 调用 API wx.switchTab 或使用组件 或用户切换 Tab 各类状况请参考下表  

Tab 切换对应的生命周期(以 A、B 页面为 Tabbar 页面,C 是从 A 页面打开的页面,D 页面是从 C 页面打开的页面为例):

当前页面 路由后页面 触发的生命周期(按顺序)
A A Nothing happend
A B A.onHide(), B.onLoad(), B.onShow()
A B(再次打开) A.onHide(), B.onShow()
C A C.onUnload(), A.onShow()
C B C.onUnload(), B.onLoad(), B.onShow()
D B D.onUnload(), C.onUnload(), B.onLoad(), B.onShow()
D(从分享进入) A D.onUnload(), A.onLoad(), A.onShow()
D(从分享进入) B D.onUnload(), B.onLoad(), B.onShow()

4.参数传递

(1)经过路径传递参数

经过路径传递参数在wx.navigateTo(OBJECT)wx.redirectTo(OBJECT)<navigator/>中使用方法相同 
示例代码:以wx.navigateTo为表明

wx.navigateTo({
  url: 'test?id=1'//实际路径要写全
})
//test.js
Page({
  onLoad: function(option){
    console.log(option.id)  
  }
})

参数与路径之间使用?分隔,参数键与参数值用=相连,不一样参数用&分隔; 

test?id=1
 中id为参数键,1 为参数值 
在目的页面中onLoad()方法中option对象即为参数对象,能够经过参数键来取出参数值

相关文章
相关标签/搜索