孟习笔谈
页面间传参的五种方式
发布时间:
总述
由于经常需要进行页面间传参且各种传参的业务场景也不相同，根据官方文档和日常工作进行了总结。共有五种传参方式
| 方式 | 优点 | 缺点 |
|---|---|---|
| globalData | 双向传参、全应用可用 | 不及时 |
| storage | 双向传参、全应用可用 | 不及时 |
| 路由 | 简单方便、及时 | 正向传参 |
| 通信通道 | 双向传参、及时 | 仅wx.navagateTo()接口调用才可用 |
| 页面栈 | 可操作数据和函数、及时 | 反向传参、仅wx.navagateTo()和 |
1、使用globalData
说明：globalData是小程序app.js中固定的一个属性，存储的数据可在全项目任意处使用
代码示例：
js
// app.js
App({
globalData:{},
})
// aaa.js
const app = getApp();
app.globalData.name='xiaowang';
// bbb.js
const app = getApp();
console.log(app.globalData.name) //xiaowang
2、使用storage
说明：storage是微信分给每个小程序的缓存，单个参数最大1M，数据总和最大10M
代码示例：
js
// aaa.js
Page({
data:{
name:'xiaowang'
},
})
//只支持原生类型、Date、及能够通过JSON.stringify序列化的对象
wx.setStorageSync('name',this.data.name)
// bbb.js
console.log(wx.getStorageSync(name)) //xiaowang
3、使用url
说明：url上直接携带参数长度是有限的且不支持特殊符号，可用编码、解码的方式解决
代码示例：
3.1 api跳转
js
// aaa.js
//跳转到 tabBar 页面，并关闭其他所有非 tabBar 页面
wx.switchTab({
url:'/bbb?id=1',
})
//关闭所有页面，打开到应用内的某个页面
wx.reLaunch({
url: '/bbb?id=1',
})
//关闭当前页面，跳转到应用内的某个页面。但是不允许跳转到 tabbar 页面
wx.redirectTo({
url: '/bbb?id=1',
})
//保留当前页面，跳转到应用内的某个页面。但是不能跳到 tabbar 页面。
wx.navigateTo({
url: '/bbb?id='+ encodeURIComponent(this.data.id),
})
//以上四种路由方式在传参和接参上没有任何区别
// bbb.js
Page({
//地址传参带过来的参数只能在该方法的options参数中获取
onLoad:function(options){
console.log(decodeURIComponent(options.id)) //'1' ,无论传的变量是数字、布尔还是对象接收的时候都是字符串
},
})
3.2 组件跳转
js
// aaa.wxml
<view>
<navigator open-type="switchTab" url="/bbb?id=1">跳转到 tabBar 页面，并关闭其他所有非 tabBar 页面</navigator>
<navigator open-type="reLaunch" url="/bbb?id=1">关闭所有页面，打开到应用内的某个页面</navigator>
<navigator open-type="redirectTo" url="/bbb?id=1">关闭当前页面，跳转到应用内的某个页面。但是不允许跳转到 tabbar 页面</navigator>
<navigator open-type="navigateTo" url="/bbb?id=1">保留当前页面，跳转到应用内的某个页面。但是不能跳到 tabbar 页面</navigator>
</view>
//以上四种路由方式在传参和接参上没有任何区别
js
// bbb.wxml
Page({
//地址传参带过来的参数只能在该方法的options参数中获取
onLoad:function(options){
console.log(options.id) //'1' ,无论传的变量是数字、布尔还是对象接收的时候都是字符串
},
})
4、使用通信通道
说明：通信通道是wx.navitageTo()独有的 代码示例：
js
// aaa.js
wx.navigateTo({
url: '/bbb?id=1',
events: {
// 为指定事件添加一个监听器，获取被打开页面传送到当前页面的数据
acceptDataFromOpenedPage: function(data) {//参数名字随便起，前后页面对应上即可
//对发送回来的数据进行处理
console.log(data)
},
someEvent: function(data) {//参数名字随便起，前后页面对应上即可
console.log(data)
}
},
success: function(res) {
// 通过eventChannel向被打开页面传送数据
res.eventChannel.emit('acceptDataFromOpenerPage', { data: 'test' })//参数名字随便起，前后页面对应上即可
},
})
//bbb.js
Page({
onLoad: function(option){
//获取通信通道
const eventChannel = this.getOpenerEventChannel()
// 监听acceptDataFromOpenerPage事件，获取上一页面通过eventChannel传送到当前页面的数据
eventChannel.on('acceptDataFromOpenerPage', function(data) {
//对发送过来的数据进行处理
console.log(data)
})
//向上一页面发送数据
eventChannel.emit('acceptDataFromOpenedPage', {data: 'test'});
eventChannel.emit('someEvent', {data: 'test'});
},
})
5、使用页面栈
说明：只对当前页面栈中存在的页面生效 代码示例：
js
// aaa.js
Page({
data:{
name:'xiaowang',
age:22
},
eatFood:function(food){
console.log('eating '+ food)
},
})
// bbb.js
Page({
onLoad: function (options) {
//获取当前页面栈
const pages = getCurrentPages();
//获取上一页面对象
let prePage = pages[pages.length - 2];
console.log(prePage.data.name) //'xiaowang'
prePage.eatFood('apple')//eating apple
},
})
总结
- 1、globalData与storage原理相同都是将数据放在一个公共的地方全应用随意取用，但是他们的数据不推送也不关联，即globalData和storage中的数据更新了，但已经获取过值的页面其对应的值并 不会更新。
解决办法： 将各页面获取值的事件放到onShow()中，每次页面进入前台的时候都会重新从globalData和storage中取值。 - 2、路由携带参数简单方便，但是地址长度有限不能携带大量参数和特殊符号。
解决办法： 在传参之前进行编码encodeURIComponent()，接收的时候进行解码 decodeURIComponent()。如此大量参数可以携带但是只能单方面传递参数，即只能a向b传，反之则不行。 - 3、通信通道，页面可以互相传参，但是该通道仅存在于wx.navagateTo()的接口调用时才有效。
- 4、页面栈，这是一个极其强大功能，它本质上不是向页面传参而是直接修改页面参数和方法。通过页面栈我们可以拿到该页面的对象，然后就可以对该页面的各项数据和函数进行操作。但是这种方法只能在b页面去操作a页面，并不能在a页面操作b页面，因为此时页面栈中还没有b。并且该方法也仅限于通过wx.navagateTo()或
跳转 这两种方式进入b页面才可使用，因为其他方式跳转到b页面时已经销毁了其他所有页面，页面栈中已经没有上一个页面了。
————————————————
js
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
原文链接：https://blog.csdn.net/zhaoguang2018/article/details/124500593