快捷導(dǎo)航

uni-app實現(xiàn)全局變量的方式小結(jié)

更新時間：2024年12月10日 08:55:24 作者：Microi風(fēng)閑

uni-app是一個使用 Vue.js 開發(fā)所有前端應(yīng)用的框架,開發(fā)者編寫一套代碼,可發(fā)布到 iOS、Android、Web（響應(yīng)式）、以及各種小程序,下面我們就來看看uni-app實現(xiàn)全局變量有哪些方法吧

一、uni-app介紹

uni-app 是一個使用 Vue.js 開發(fā)所有前端應(yīng)用的框架，開發(fā)者編寫一套代碼，可發(fā)布到 iOS、Android、Web（響應(yīng)式）、以及各種小程序（微信/支付寶/百度/頭條/飛書/QQ/快手/釘釘/淘寶）、快應(yīng)用等多個平臺。

uni-app 在開發(fā)者數(shù)量、案例、跨端抹平度、擴展靈活性、性能體驗、周邊生態(tài)、學(xué)習(xí)成本、開發(fā)成本等8大關(guān)鍵指標上擁有更強的優(yōu)勢。

二、功能框架圖

從下面 uni-app 功能框架圖可看出， uni-app 在跨平臺的過程中，不犧牲平臺特色，可優(yōu)雅的調(diào)用平臺專有能力，真正做到海納百川、各取所長。

三、公用模塊

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

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

示例如下：

在 uni-app 項目根目錄下創(chuàng)建 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 中引用該模塊

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

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

四、掛載 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 中調(diào)用

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

這種方式，只需要在 main.js 中定義好即可在每個頁面中直接調(diào)用。

Tips

每個頁面中不要在出現(xiàn)重復(fù)的屬性或方法名。
建議在 Vue.prototype 上掛載的屬性或方法，可以加一個統(tǒng)一的前綴。比如 $url、global_url 這樣，在閱讀代碼時也容易與當前頁面的內(nèi)容區(qū)分開。

五、globalData

小程序中有個 globalData 概念，可以在 App 上聲明全局變量。 Vue 之前是沒有這類概念的，但 uni-app 引入了globalData概念，并且在包括H5、App等平臺都實現(xiàn)了。

在 App.vue 可以定義 globalData ，也可以使用 API 讀寫這個值。

globalData 支持 vue 和 nvue 共享數(shù)據(jù)。
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 的數(shù)據(jù)綁定到頁面上，可在頁面的 onshow 聲明周期里進行變量重賦值。HBuilderX 2.0.3起，nvue頁面在 uni-app 編譯模式下，也支持 onshow 。

六、Vuex

Vuex 是一個專為 Vue.js 應(yīng)用程序開發(fā)的狀態(tài)管理模式。它采用集中式存儲管理應(yīng)用的所有組件的狀態(tài)，并以相應(yīng)的規(guī)則保證狀態(tài)以一種可預(yù)測的方式發(fā)生變化。

HBuilderX 2.2.5+起，支持vue和nvue之間共享。參考

這里以登錄后同步更新用戶信息為例，簡單說明下 Vuex 的用法，更多更詳細的 Vuex 的內(nèi)容，建議前往其官網(wǎng) Vuex 學(xué)習(xí)下。

舉例說明：

在 uni-app 項目根目錄下新建 store 目錄，在 store 目錄下創(chuàng)建 index.js 定義狀態(tài)值

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 {  
        mapState,  
        mapMutations  
    } from 'vuex';  
 
    export default {  
        computed: {  
            ...mapState(['avatarUrl', 'login', 'userName'])  
        },  
        methods: {  
            ...mapMutations(['logout'])  
        }  
    }

示例操作步驟：

未登錄時，提示去登錄。跳轉(zhuǎn)至登錄頁后，點擊“登錄”獲取用戶信息，同步更新狀態(tài)后，返回到個人中心即可看到信息同步的結(jié)果。

注意：對比前面的方式，該方式更加適合處理全局的并且值會發(fā)生變化的情況。