一. 前言
由于经常需要进行页面间传参且各种传参的业务场景也不相同,根据官方文档和日常工作进行了总结。共有六种传参方式
二. 实现方式
1、使用globalData
-
说明:globalData是小程序app.js中固定的一个属性,存储的数据可在全项目任意处使用
-
代码示例:
// app.js
App({
globalData:{
name:zhangsan
},
})
// index.js
const app = getApp();
app.globalData.name='xiaowang';
// list.js
const app = getApp();
console.log(app.globalData.name) //xiaowang
2、使用storage
说明:storage是微信分给每个小程序的缓存,单个参数最大1M,数据总和最大10M
代码示例:
// index.js
Page({
data:{
name:'xiaowang'
},
})
//只支持原生类型、Date、及能够通过JSON.stringify序列化的对象
wx.setStorageSync('name',this.data.name)
// list.js
console.log(wx.getStorageSync(name)) //xiaowang
3、使用url (路由传参)
说明:url上直接携带参数长度是有限的且不支持特殊符号,可用编码、解码的方式解决
代码示例:
- 3.1 api跳转
// index.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),
})
//以上四种路由方式在传参和接参上没有任何区别
// list.js
Page({
//地址传参带过来的参数只能在该方法的options参数中获取
onLoad:function(options){
console.log(decodeURIComponent(options.id)) //'1' ,无论传的变量是数字、布尔还是对象接收的时候都是字符串
},
})
- 3.2 组件跳转
// index.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>
//以上四种路由方式在传参和接参上没有任何区别
// list.js
Page({
//地址传参带过来的参数只能在该方法的options参数中获取
onLoad:function(options){
console.log(options.id) //'1' ,无论传的变量是数字、布尔还是对象接收的时候都是字符串
},
})
4. 组件传值
父传子
在父组件中,使用自己写的子组件,传递的值名称是detail
<-- 父组件的wxml -->
<classDetail detail="{{item}}"></classDetail>
//父组件的js
data:{
item:"我是父组件"
}
要把子组件注册进去
//父组件的json
"usingComponents": {
"classDetail": "./components/classDetail/index"
}
父子组件都注册好了,接下来是传值
父传子: 依照上方图片下来,子组件classDetail已经绑定好一个detail的传输变量,接下来要完成子组件对父组件变量的接收
在子组件的js中,注册一下传递过来的变量
//子组件的js
properties:{
detail: String
},
子组件:
<-- 子组件的wxml -->
<view>{{detail}}<view>
子组件就可以成功渲染出{{detail}}了
子传父
//子组件.wxml
<button bindtap="changeSelect">添加</button>
- 在子组件当中通过
this.triggerEvent("自定义事件名",要传递的数据)
//子组件的js
changeSelect(){
this.triggerEvent("updataSelect", this.data.index)
},
- 在父组件的子标签中声明自定义事件
bind:自定义事件名="事件名" - 注意,这里的
changeSelect是父组件js里的方法名称,updataSelect是子组件js里传递的方法名称
//父组件的wxml
<shudanbook index="{{ index }}" bind:updataSelect="changeSelect" ></shudanbook>
- 在父组件的js中通过默认参数来获取子组件传递的值
//父组件的js
changeSelect(e){
//获得传递过来的值
console.log(e.detail)
},
5、使用通信通道
说明:通信通道是wx.navitageTo()独有的
代码示例:
// index.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' })//参数名字随便起,前后页面对应上即可
},
})
//list.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'});
},
})
6、使用页面栈
说明:只对当前页面栈中存在的页面生效
代码示例:
// index.js
Page({
data:{
name:'xiaowang',
age:22
},
eatFood:function(food){
console.log('eating '+ food)
},
})
// list.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
},
})
三 .总结
-
globalData与storage原理相同都是将数据放在一个公共的地方全应用随意取用,但是他们的数据不推送也不关联,即globalData和storage中的数据更新了,但已经获取过值的页面其对应的值并 不会更新。 解决办法:将各页面获取值的事件放到onShow()中,每次页面进入前台的时候都会重新从globalData和storage中取值。
-
路由携带参数简单方便,但是地址长度有限不能携带大量参数和特殊符号。 解决办法:在传参之前进行编码encodeURIComponent(),接收的时候进行解码 decodeURIComponent()。如此大量参数可以携带但是只能单方面传递参数,即只能a向b传,反之则不行。
-
父子传值在传输一些组件数据时非常方便,只需要我们分辨清楚传递与获取的方式,在使用时也是比较简单,但在需要修改数据时则略显繁琐
-
通信通道,页面可以互相传参,但是该通道仅存在于wx.navagateTo()的接口调用时才有效。
-
页面栈,这是一个极其强大功能,它本质上不是向页面传参而是直接修改页面参数和方法。通过页面栈我们可以拿到该页面的对象,然后就可以对该页面的各项数据和函数进行操作。但是这种方法只能在b页面去操作a页面,并不能在a页面操作b页面,因为此时页面栈中还没有b。并且该方法也仅限于通过wx.navagateTo()或 跳转 这两种方式进入b页面才可使用,因为其他方式跳转到b页面时已经销毁了其他所有页面,页面栈中已经没有上一个页面了