uni-app 全局变量的4种实现方式

  • 一、公用模块
      • 1.在 uni-app 项目根目录下创建 common 目录，然后在 common 目录下新建 helper.js 用于定义公用的方法。
      • 2.在 pages/index/index.vue 中引用该模块
  • 二、Vuex
      • 1.在 uni-app 项目根目录下新建 store 目录，在 store 目录下创建 index.js 定义状态值
      • 2.在 main.js 挂载 Vuex
      • 3.在 pages/index/index.vue 使用
  • 三、挂载到Vue.prototype上
      • 1.在 main.js 中挂载属性/方法
      • 2.在 pages/index/index.vue 中调用
  • 四、globalData
      • 1.定义：App.vue
      • 2.js中操作globalData的方式如下：

一、公用模块

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

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

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

2.在 pages/index/index.vue 中引用该模块

<script>import helper from '../../common/helper.js';export default {data() {return {};},onLoad(){console.log('now:' + helper.now());},methods: {}}</script>

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

二、Vuex

Vuex 是一个专为 Vue.js 应用程序开发的状态管理模式。它采用集中式存储管理应用的所有组件的状态，并以相应的规则保证状态以一种可预测的方式发生变化。
HBuilderX 2.2.5+起，支持vue和nvue之间共享

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

const store = new Vuex.Store({state: {login: false,token: '',avatarUrl: '',userName: ''},mutations: {login(state, provider) {console.log(state)console.log(provider)state.login = true;state.token = provider.token;state.userName = provider.userName;state.avatarUrl = provider.avatarUrl;},logout(state) {state.login = false;state.token = '';state.userName = '';state.avatarUrl = '';}}})

2.在 main.js 挂载 Vuex

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

3.在 pages/index/index.vue 使用

<script>import {mapState,mapMutations} from 'vuex';export default {computed: {...mapState(['avatarUrl', 'login', 'userName'])},methods: {...mapMutations(['logout'])}}</script>

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

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

三、挂载到Vue.prototype上

将一些使用频率较高的常量或者方法，直接扩展到 Vue.prototype 上，每个 Vue 对象都会“继承”下来。
注意这种方式只支持vue页面
示例如下：

1.在 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;};

2.在 pages/index/index.vue 中调用

<script>export default {data() {return {};},onLoad(){console.log('now:' + this.now());},methods: {}}</script>

这种方式，只需要在 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是一种比较简单的全局变量使用方式。

1.定义：App.vue

<script>export default {globalData: {text: 'text'},onLaunch: function() {console.log('App Launch')},onShow: function() {console.log('App Show')},onHide: function() {console.log('App Hide')}}</script><style>/*每个页面公共css */</style>

2.js中操作globalData的方式如下：

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

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

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

uni-app全局变量的几种方式