小程序页面间传参

时间:2022-09-28 sKK07 人气:0

前言

由于经常需要进行页面间传参且各种传参的业务场景也不相同，根据官方文档和日常工作进行了总结。共有五种传参方式，各位有什么关于页面间传参的奇思妙想也可在评论区提出，大家共同探讨

概览：

方式	优点	缺点
`globalData`	双向传参、全应用可用	不及时
`storage`	双向传参、全应用可用	不及时
`路由`	简单方便、及时	正向传参
`通信通道`	双向传参、及时	仅`wx.navagateTo()`接口调用才可用
`页面栈`	可操作数据和函数、及时	反向传参、仅`wx.navagateTo()`和`<navigator open-type="navigateTo" url="/bbb?id=1"></navigator>` 才可用

1、使用globalData

说明：globalData是小程序app.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

代码示例：

// 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跳转

// 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 组件跳转

// 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>
//以上四种路由方式在传参和接参上没有任何区别

// bbb.wxml
Page({
  //地址传参带过来的参数只能在该方法的options参数中获取
  onLoad:function(options){
    console.log(options.id) //'1' ,无论传的变量是数字、布尔还是对象接收的时候都是字符串
  },
})

4、使用通信通道

说明：通信通道是wx.navitageTo()独有的

代码示例：

// 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、使用页面栈

说明：只对当前页面栈中存在的页面生效

代码示例：

// 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
  },
})

总结

globalData与storage原理相同都是将数据放在一个公共的地方全应用随意取用，但是他们的数据不推送也不关联，即globalData和storage中的数据更新了，但已经获取过值的页面其对应的值并不会更新。
解决办法：将各页面获取值的事件放到onShow()中，每次页面进入前台的时候都会重新从globalData和storage中取值。
路由携带参数简单方便，但是地址长度有限不能携带大量参数和特殊符号。
解决办法：在传参之前进行编码encodeURIComponent()，接收的时候进行解码 decodeURIComponent()。如此大量参数可以携带但是只能单方面传递参数，即只能a向b传，反之则不行。
通信通道，页面可以互相传参，但是该通道仅存在于wx.navagateTo()的接口调用时才有效。
页面栈，这是一个极其强大功能，它本质上不是向页面传参而是直接修改页面参数和方法。通过页面栈我们可以拿到该页面的对象，然后就可以对该页面的各项数据和函数进行操作。但是这种方法只能在b页面去操作a页面，并不能在a页面操作b页面，因为此时页面栈中还没有b。并且该方法也仅限于通过wx.navagateTo()或 <navigator open-type="navigateTo" url="/bbb?id=1">跳转</navigator> 这两种方式进入b页面才可使用，因为其他方式跳转到b页面时已经销毁了其他所有页面，页面栈中已经没有上一个页面了。

加载全部内容