Trust
Trust
  • 发布:2018-09-13 12:08
  • 更新:2021-08-05 11:19
  • 阅读:262509

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

分类:uni-app

公用模块

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

注意这种方式只支持多个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 中运行。

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

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

注意事项

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

更多

关于登录状态的维护,还可以参考 uni-app 的登录模板示例。可以在 github 获取源码,也可以在新建 uni-app 时“从模板创建”选择登录模板。

126 关注 分享
Neil_HL fx4399 小U 2***@qq.com Geeker x***@sina.com zhangdaren 1***@qq.com 辉辉 海中月是天上月 MARKF 沧桑 w***@163.com 小小嘻嘻嘻嘻嘻 偶是小菜鸟 罪途 6***@qq.com 6***@qq.com w***@163.com quitter 望 1***@qq.com 白小白73 3***@qq.com 拜仁已伤 7***@qq.com 1***@qq.com YongwangLee 8***@qq.com 2***@qq.com 脉脉情缘 s***@gmail.com 6***@qq.com 7***@qq.com echoer w***@163.com 6***@qq.com f***@163.com 1***@qq.com 2***@qq.com 1***@qq.com Heng_vv 阿顺 林上皓 吴老二测试项目 t***@sina.cn MK 6***@qq.com b***@qq.com 8***@qq.com

要回复文章请先登录注册

liunewshine

liunewshine

globalData是响应式的吗?支持Vue.observable这种简单的类似vuex的功能吗
2021-08-05 11:19
4***@qq.com

4***@qq.com

”挂载 Vue.prototype“ 这种定义全局函数的时候,在函数内部不能访问uniCloud云函数吗?
2021-01-13 16:58
z***@qq.com

z***@qq.com

那么意思是:在 nvue 中如果要实现全局方法共享,只能是一个一个引入了?也就是文章开头的公用模块
2020-12-31 19:58
2***@qq.com

2***@qq.com

我创建了一个 demo 注释掉 Vue.prototype.$store = store 这行代码跑了一下, 也是正常的, 这行代码好像是多余的!!!
2020-12-31 16:55
2***@qq.com

2***@qq.com

用 uni-app 开发的时候在 app.vue 里为什么需要多加 Vue.prototype.$store = store 这一行代码? 一般不是实例化 app组件的时候将 store 传入选项对象中就可以了吗 ?开发 app 时有什么不一样吗?
2020-12-31 16:36
y***@qq.com

y***@qq.com

回复 无赖君子 :
万一uni api更新了和你挂载的属性冲突了怎么办?
2020-11-26 17:34
1***@qq.com

1***@qq.com

这个比$on 好用多了 那个在h5页面可以用;微信小程序本页面可以用,兄弟页面不可以用,bug,求解决
2020-11-22 00:42
YXW

YXW

回复 7***@qq.com :
牛逼
2020-11-17 18:47
MonikaChen

MonikaChen

关注收藏
2020-11-16 23:07
无赖君子

无赖君子

回复 无赖君子 :
比如uni.globalData = { test: 11, ... }
2020-11-15 23:58