【Web技术】995- uniapp页面通信方法总汇

港控/mmm° 2022-10-08 14:25 193阅读 0赞

![5feab26a930fbd86806595138af33357.png][]

文章整理于：https://ask.dcloud.net.cn/article/35970

uni-app 是一个使用 vue.js 开发所有前端应用的框架，开发者编写一套代码，可发布到iOS、Android、Web（响应式）、以及各种小程序（微信/支付宝/百度/头条/QQ/钉钉/淘宝）、快应用等多个平台。

## **利用url传参进行通讯** ##

A页面向B页面传递参数

uni.navigateTo({      url: 'test/test?id=1&url=' + encodeURIComponent('https://dcloud.io')  });

B页面接收A页面传递的参数

export default {      onLoad: function (option) { //option为object类型，会序列化上个页面传递的参数          console.log(option.id); //打印出上个页面传递的参数。        console.log(option. url); //打印出上个页面传递的参数。    }  }

## **uni.$emit()和uni.$on() 进行通讯** ##

自 HBuilderX 2.0.0 起支持 uni.$emit、 uni.$on 、 uni.$once 、uni.$off ，可以方便的进行页面的通讯 ，触发的事件都是 App 全局级别的，跨任意组件，页面，nvue，vue 等。

具体如何使用呢？我们假设一个场景，进入app,是未登陆状态，需要在我的页面点击登陆，进入登陆页面进行登陆。登陆成功之后，返回到我的页面，实时显示登陆后的用户信息。

#### **监听事件** ####

首先，在我的页面监听事件。

// 我的页面  onLoad(){      // 监听事件      uni.$on('login',(usnerinfo)=>{          this.usnerinfo = usnerinfo;      })  },  onUnload() {      // 移除监听事件          uni.$off('login');      },

因为事件监听是全局的，所以使用 uni.$on ，需要使用 uni.$off 移除全局的事件监听，避免重复监听。

#### **触发事件** ####

进入登陆页面，触发事件

// 登陆页面  uni.$emit('login', {        avatarUrl: 'https://img-cdn-qiniu.dcloud.net.cn/uploads/nav_menu/10.jpg',        token: 'user123456',        userName: 'unier',        login: true  });

使用 uni.$emit 触发事件后，对应的 uni.$on 就会监听到事件触发，在回调中去执行相关的逻辑。

#### **更多使用场景** ####

以上只是一个简单的场景应用。而我们开发中会遇到很多页面间通讯场景，如：

*  vue 与 nvue，nvue 与 vue 间的通讯
 *  tabbar 页面之间的通讯
 *  父页面与多级子页面间的通讯

基本上述场景均可以实现，本质上就是一个页面通知另一个面我发生了变化，你需要处理一下。

绝大部分页面的通讯都可以使用 uni.$emit、 uni.$on 、 uni.$once 、uni.$off 四个事件完成。

**Tips**

*  如果页面没有打开，将不能 注册监听事件 uni.$on 和 uni.$once 。
 *  一次性的事件，直接使用 uni.$once 监听，不需要移除。

## 使用 EventBus 进行通讯 ##

// 将eventBus对象注册到Vue的原型上

Vue.prototype.$eventBus = new Vue()

// 在 A 页面添加点击事件向 B 页面发送消息

<button @click=“sendMsg”>Send</button>
    sendMsg() {  this.$eventBus.$emit(“getId”, 12)}

// 在 B 页面注册监听事件

created() {  this.$eventBus.$on(“getId”, function(id) {     this.id = id   }}

## **利用“全局变量”进行通讯** ##

#### **公用模块** ####

定义一个专用的模块，用来组织和管理这些全局的变量，在需要的页面引入。

注意，这种方式只支持多个vue页面或多个nvue页面之间公用，vue和nvue之间不公用。

示例如下：  
在 uni-app 项目根目录下创建 common 目录，然后在 common 目录下新建 helper.js 用于定义公用的方法。

接下来在 pages/index/index.vue 中引用该模块。

这种方式维护起来比较方便，但是缺点就是每次都需要引入。

#### **挂载 Vue.prototype** ####

将一些使用频率较高的常量或者方法，直接扩展到 Vue.prototype 上，每个 Vue 对象都会“继承”下来。

**注意这种方式只支持vue页面**

示例如下：  
在 main.js 中挂载属性/方法

Vue.prototype.websiteUrl = 'http://uniapp.dcloud.io';  Vue.prototype.now = Date.now || function () {      return new Date().getTime();  };  Vue.prototype.isArray = Array.isArray || function (obj) {      return obj instanceof Array;  };

然后在 pages/index/index.vue 中调用

这种方式，只需要在 main.js 中定义好即可在每个页面中直接调用。

**Tips**

*  每个页面中不要在出现重复的属性或方法名。
 *  建议在 Vue.prototype 上挂载的属性或方法，可以加一个统一的前缀。比如 $url、global\_url 这样，在阅读代码时也容易与当前页面的内容区分开。

#### **globalData** ####

小程序中有个globalData概念，可以在 App 上声明全局变量。Vue 之前是没有这类概念的，但 uni-app 引入了globalData概念，并且在包括H5、App等平台都实现了。

在 App.vue 可以定义 globalData ，也可以使用 API 读写这个值。

globalData支持vue和nvue共享数据。

globalData是一种比较简单的全局变量使用方式。

定义：App.vue

js中操作globalData的方式如下：

赋值：getApp().globalData.text = 'test'

取值：console.log(getApp().globalData.text) // 'test'

如果需要把globalData的数据绑定到页面上，可在页面的onshow声明周期里进行变量重赋值。HBuilderX 2.0.3起，nvue页面在uni-app编译模式下，也支持onshow。

#### **Vuex** ####

Vuex 是一个专为 Vue.js 应用程序开发的状态管理模式。它采用集中式存储管理应用的所有组件的状态，并以相应的规则保证状态以一种可预测的方式发生变化。

HBuilderX 2.2.5+起，支持vue和nvue之间共享。参考

这里以登录后同步更新用户信息为例，简单说明下 Vuex 的用法，更多更详细的 Vuex 的内容，建议前往其官网 Vuex 学习下。

**举例说明：**

在 uni-app 项目根目录下新建 store 目录，在 store 目录下创建 index.js 定义状态值。

然后，需要在 main.js 挂载 Vuex

import store from './store'  Vue.prototype.$store = store

最后，在 pages/index/index.vue 使用

详细示例，请下载附件，在 HBuilderX 中运行。

示例操作步骤：未登录时，提示去登录。跳转至登录页后，点击“登录”获取用户信息，同步更新状态后，返回到个人中心即可看到信息同步的结果。

注意：对比前面的方式，该方式更加适合处理全局的并且值会发生变化的情况。

#### **注意事项** ####

\* .vue 和 .nvue 并不是一个规范，因此一些在 .vue 中适用的方案并不适用于 .nvue。Vue 上挂载属性，不能在 .nvue 中使用。\*\*

## **nvue 和 vue 相互通讯** ##

**步骤**  
1、在nvue页面使用uni.postMessage(data),发送数据，data只能为json数据,  
2、在app.vue页面里使用 onUniNViewMessage 进行监听，接受数据  
代码示例  
nvue页面

<template>    <div @click="test">        <text>点击页面发送数据</text>    </div></template><script>    export default {        methods: {            test(e) {                uni.postMessage({test: "数据",value:"数据"});            }        }    }</script>

App.vue

![67d198a77e3933a6ca4ec2b775bdbbbf.gif][]

[1. JavaScript 重温系列（22篇全）][1. JavaScript _22]

[2. ECMAScript 重温系列（10篇全）][2. ECMAScript _10]

[3. JavaScript设计模式 重温系列（9篇全）][3. JavaScript_ _9]

4. [正则 / 框架 / 算法等 重温系列（16篇全）][_ _ _ _ _16]

5. [Webpack4 入门（上）][Webpack4]|| [Webpack4 入门（下）][Webpack4 1]

6. [MobX 入门（上）][MobX] || [MobX 入门（下）][MobX 1]

7. 120[\+篇原创系列汇总][Link 1]

![4bdd2fbcb107e267f63b7d6d37b5ede6.gif][]

回复“**加群**”与大佬们一起交流学习~

点击“**阅读原文**”查看 120+ 篇原创文章

[5feab26a930fbd86806595138af33357.png]: /images/20221005/d672e15a85ed4c5abf7e38129f0909b5.png
[67d198a77e3933a6ca4ec2b775bdbbbf.gif]: /images/20221005/b678eead31b245bbb743f70b3cb5db58.png
[1. JavaScript _22]: http://mp.weixin.qq.com/s?__biz=MjM5MDc4MzgxNA%3D%3D&chksm=b1c224ea86b5adfc10c3aa1841be3879b9360d671e98cc73391c2490246f1348857b9821d32c&idx=1&mid=2458453187&scene=21&sn=a69b4d7d991867a07a933f86e66b9f55#wechat_redirect
[2. ECMAScript _10]: http://mp.weixin.qq.com/s?__biz=MjM5MDc4MzgxNA%3D%3D&chksm=b1c224e086b5adf6dad41a0d36b77a9bfb4bc9f0d29a816266b3e28c892e54274967dbce380b&idx=1&mid=2458453193&scene=21&sn=e5392cb77bc17c9e94b6c826b5f52a83#wechat_redirect
[3. JavaScript_ _9]: http://mp.weixin.qq.com/s?__biz=MjM5MDc4MzgxNA%3D%3D&chksm=b1c224e386b5adf554ab928cdeaf7ee16dbb2d895be17f2a12a59054a75b913470ca7649bbc7&idx=1&mid=2458453194&scene=21&sn=e7f0734b04484bee5e10a85a7cbb85c1#wechat_redirect
[_ _ _ _ _16]: http://mp.weixin.qq.com/s?__biz=MjM5MDc4MzgxNA%3D%3D&chksm=b1c224e286b5adf432850f82db18cc8647d639836798cf16b478d9a6f7c81df87c6da5257684&idx=1&mid=2458453195&scene=21&sn=1e0c8b7ea8ddc207b523ec0a636a5254#wechat_redirect
[Webpack4]: http://mp.weixin.qq.com/s?__biz=MjM5MDc4MzgxNA%3D%3D&chksm=b1c2251f86b5ac09dbbbb7c8e1d80c6cbd793a523cdfa690f8734def57812e616b9906aeec79&idx=1&mid=2458453302&scene=21&sn=904e40a421024ea0d394e9850b674012#wechat_redirect
[Webpack4 1]: http://mp.weixin.qq.com/s?__biz=MjM5MDc4MzgxNA%3D%3D&chksm=b1c2251e86b5ac08464872cd880811423e0d1bbcebbe11dcac9d99fa38c5332c089c06d65d95&idx=1&mid=2458453303&scene=21&sn=422f2b5e22c3b0e91a8353ee7e53fed9#wechat_redirect
[MobX]: http://mp.weixin.qq.com/s?__biz=MjM5MDc4MzgxNA%3D%3D&chksm=b1c2264c86b5af5aa7300a04d55efead6223e310d68e10222cd3577a25c783d3429f00767960&idx=1&mid=2458453605&scene=21&sn=0a506769d5eeb7953f676e93fb4d18eb#wechat_redirect
[MobX 1]: http://mp.weixin.qq.com/s?__biz=MjM5MDc4MzgxNA%3D%3D&chksm=b1c2264086b5af5611524eedb0d409afe86d859dce6ceff1c17ddab49d353c385e45611a73fa&idx=1&mid=2458453609&scene=21&sn=f0c22e82f2537204d9b173161bae6b82#wechat_redirect
[Link 1]: http://mp.weixin.qq.com/s?__biz=MjM5MDc4MzgxNA%3D%3D&chksm=b1c224dd86b5adcbd98189315e60de6a0106993690b69927cc1c1f19fd8f591fefce4e3db51f&idx=2&mid=2458453236&scene=21&sn=daf00392f960c115463c5aaf980620b4#wechat_redirect
[4bdd2fbcb107e267f63b7d6d37b5ede6.gif]: /images/20221005/9370d062c1a041a888f725ce7e32c76b.png