uniapp 实现全局变量

发布于:2025-07-30 ⋅ 阅读:(14) ⋅ 点赞:(0)

1. uniapp 实现全局变量

  在UniApp中定义全局变量可以通过多种方式进行,包括但不限于使用globalData属性、挂载到Vue.prototype、使用Vuex状态管理、创建公用模块以及利用本地存储(如uni.setStorage、uni.getStorage)。

1.1. 通过globalData属性

  在UniApp中,每个页面都是一个Vue组件,因此可以利用Vue的data属性来定义全局变量。不过这种方式仅限于当前组件的作用域,无法跨页面共享。若要实现全局共享,需要配合其他手段。
小程序中可以在 App 上声明全局变量,但在 Vue 中没有,然而uni-app因同时兼容小  程序而使用的语法是vue的缘故,我们便可以在 App.vue 中定义 globalData 属性,也可以使用 API 读写这个值。

1.1.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>  

1.1.2. 赋值

getApp().globalData.text = 'test'

  如果需要把globalData的数据绑定到页面上,可在页面的onshow声明周期里进行变量重赋值。

1.1.3. 取值

console.log(getApp().globalData.text) // 'test'

1.1.4. 注意

  (1)支持vue和nvue共享数据。是目前nvue和vue共享数据的一种比较好的方式
  (2)HBuilderX 2.0.3起,nvue页面在uni-app编译模式下,也支持onshow。

1.2. 挂载到Vue.prototype

  在项目开发中,我们可以将一些使用频率较高的常量或者方法,直接扩展到 Vue.prototype 上,这样会使每个 Vue 对象都会“继承”下来。

1.2.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;  
};  

1.2.2. pages/index/index.vue 中调用

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

1.2.3. 注意

  (1)每个页面中不要在出现重复的属性或方法名。
  (2)只需要在 main.js 中定义好即可在每个页面中直接调用。
  (3)建议在 Vue.prototype 上挂载的属性或方法,可以加一个统一的前缀。比如 $url、global_url 这样,在阅读代码时也容易与当前页面的内容区分开。
  (4)注意这种方式只支持多个vue页面或多个nvue页面之间公用,vue和nvue之间不公用。

1.3. 使用Vuex状态管理

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

1.3.1. 在根目录下新建store目录, 在store目录下创建index.js定义状态值

import Vue from 'vue';
import Vuex from 'Vuex';
import Vuex from 'vuex';
Vue.use(Vuex);

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 = '';  
        }  
    }  
})

export default store

1.3.2. 在main.js挂载Vuex

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

1.3.3. 在页面中使用

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

1.3.4. 注意

  (1)只支持多个vue页面或多个nvue页面之间公用,vue和nvue之间不公用。
  (2)对比前面的方式,该方式更加适合处理全局的并且值会发生变化的情况。
  (3).vue 和 .nvue 并不是一个规范,因此一些在 .vue 中适用的方案并不适用于 .nvue。
  (4)Vue 上挂载属性,不能在 .nvue 中使用。
  (5).nvue 不支持 vuex
  (6)如果希望 .vue 和 .nvue 复用一些方法的话,需要采用公用模块的方案,分别在 .vue 和 .nvue 文件中引入。

1.4.利用本地存储

  可以使用UniApp提供的本地存储API,如uni.setStorage和uni.getStorage,来存储和获取全局变量。这种方法适用于需要在应用重启后仍然保留的全局变量。

1.5.利用本地存储创建公用模块

  可以在项目中新建一个js文件,定义一个专用的模块,用来管理全局的变量,在有需要的地方进行引入。

1.5.1 代码示例

  (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>  

1.5.2. 注意

  (1)维护方便,但是每次使用需要引入。
  (2)只支持多个vue页面或多个nvue页面之间公用,vue和nvue之间不公用。
  以上就是在UniApp中定义全局变量的几种方法。在实际开发中,可以根据项目的具体需求和规模选择合适的方式来定义和管理全局变量。


网站公告

今日签到

点亮在社区的每一天
去签到