Skip to content

页面间传参的五种方式

发布时间:

总述

由于经常需要进行页面间传参且各种传参的业务场景也不相同,根据官方文档和日常工作进行了总结。共有五种传参方式

方式优点缺点
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