微信小程序 页面跳转和数据传递实例详解
微信小程序 页面跳转和数据传递
1.先导
在android中,我们activity和fragment都有栈的概念在里面,微信小程序页面也有栈的概念在里面。微信小程序页面跳转有四种方式:
1.wx.navigateto(object);
2.wx.redirectto(object);
3.wx.switchtab(object);
4.wx.navigateback(object)
5.使用实现对应的跳转功能;
分析:
- 其中navigateto是将原来的页面保存在页面栈中,在跳入到下一个页面的时候目标页面也进栈,只有在这个情况下点击手机的返回按钮才可以跳转到上一个页面;
- redirectto和switchtab都是先清除栈中原来的页面,然后目标页面进栈,使用这两种跳转方式,都不能通过系统的返回键回到上一个页面,而是直接退出小程序;
- redirectto使用的时候一定要配合tabbar或是页面里面可以再次跳转按钮,否则无法回到上一个页面;
- switchtab跳转的页面必须是tabbar中声明的页面;
- tabbar中定义的字段不能超过5个页面,小程序的页面栈层次也不能超过5层。
- navigateback只能返回到页面栈中的指定页面,一般和navigateto配合使用。
- wx.navigateto 和 wx.redirectto 不允许跳转到 tabbar 页面,只能用 wx.switchtab 跳转到 tabbar 页面
2.页面跳转的具体操作
(1)wx.navigateto(object)
保留当前页面,跳转到应用内的某个页面,使用wx.navigateback可以返回到原页面。
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
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)
关闭当前页面,跳转到应用内的某个页面。
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
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 页面
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对象即为参数对象,可以通过参数键来取出参数值
感谢阅读,希望能帮助到大家,谢谢大家对本站的支持!