uni-app 全域性變數的幾種實現方式

阿新 • • 發佈：2021-11-06

公用模組
掛載 Vue.prototype
globalData
Vuex

公用模組

定義一個專用的模組，用來組織和管理這些全域性的變數，在需要的頁面引入。

注意這種方式只支援多個vue頁面或多個nvue頁面之間公用，vue和nvue之間不公用。

示例如下：
在 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  
}

接下來在 pages/index/index.vue 中引用該模組

<script>  
    import helper from '../../common/helper.js';  

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

這種方式維護起來比較方便，但是缺點就是每次都需要引入。

掛載 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 中呼叫

<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是一種比較簡單的全域性變數使用方式。

定義：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>

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 定義狀態值

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

然後，需要在 main.js 掛載 Vuex

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

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

<script>  
    import {  
        mapState,  
        mapMutations  
    } from 'vuex';  

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

詳細示例，請下載附件，在 HBuilderX 中執行。

示例操作步驟：
未登入時，提示去登入。跳轉至登入頁後，點選“登入”獲取使用者資訊，同步更新狀態後，返回到個人中心即可看到資訊同步的結果。

注意：對比前面的方式，該方式更加適合處理全域性的並且值會發生變化的情況。