vuex最简单、最详细的入门文档

若是你在使用 vue.js , 那么我想你可能会对 vue 组件之间的通讯感到崩溃 。

我在使用基于 vue.js 2.0 的UI框架 ElementUI 开发网站的时候 , 就遇到了这种问题 : 一个页面有不少表单 , 我试图将表单写成一个单文件组件 , 可是表单 ( 子组件 ) 里的数据和页面 ( 父组件 ) 按钮交互的时候 , 它们之间的通信很麻烦 :

<!--父组件中引入子组件--> <template> <div> <a href="javascript:;" @click="show = true">点击</a> <t-dialog :show.sync="show"></t-dialog> </div> </template> <script> import dialog from './components/dialog.vue' export default { data(){ return { show:false } }, components:{ "t-dialog":dialog } } </script> <!--子组件--> <template> <el-dialog :visible.sync="currentShow"></el-dialog> </template> <script> export default { props:['show'], computed:{ currentShow:{ get(){ return this.show }, set(val){ this.$emit("update:show",val) } } } } </script> 

之因此这么麻烦 , 是由于父组件能够经过 props 给子组件传递参数 , 但子组件内却不能直接修改父组件传过来的参数。

这时候 , 使用 vuex 就能够比较方便的解决这种问题了 :

<!--父组件中引入子组件--> <template> <div> <a href="javascript:;" @click="$store.state.show = true">点击</a> <t-dialog></t-dialog> </div> </template> <script> import dialog from './components/dialog.vue' export default { components:{ "t-dialog":dialog } } </script> <!--子组件--> <template> <el-dialog :visible.sync="$store.state.show"></el-dialog> </template> <script> export default {} </script> 

是否是方便了许多 , 这就是 vuex 最简单的应用 , 不要被网上其余教程吓到 , vuex 原来能够这么简单 !

安装、使用 vuex

首先咱们在 vue.js 2.0 开发环境中安装 vuex :

npm install vuex --save 

而后 , 在 main.js 中加入 :

import vuex from 'vuex' Vue.use(vuex); var store = new vuex.Store({//store对象 state:{ show:false } }) 

再而后 , 在实例化 Vue对象时加入 store 对象 :

new Vue({ el: '#app', router, store,//使用store template: '<App/>', components: { App } }) 

完成到这一步 , 上述例子中的 $store.state.show 就可使用了。

modules

前面为了方便 , 咱们把 store 对象写在了 main.js 里面 , 但实际上为了便于往后的维护 , 咱们分开写更好 , 咱们在 src 目录下 , 新建一个 store 文件夹 , 而后在里面新建一个 index.js :

import Vue from 'vue' import vuex from 'vuex' Vue.use(vuex); export default new vuex.Store({ state:{ show:false } }) 

那么相应的 , 在 main.js 里的代码应该改为 :

//vuex import store from './store' new Vue({ el: '#app', router, store,//使用store template: '<App/>', components: { App } })

这样就把 store 分离出去了 , 那么还有一个问题是 : 这里 $store.state.show 不管哪一个组件均可以使用 , 那组件多了以后 , 状态也多了 , 这么多状态都堆在 store 文件夹下的 index.js 很差维护怎么办 ?

咱们可使用 vuex 的 modules , 把 store 文件夹下的 index.js 改为 :

import Vue from 'vue' import vuex from 'vuex' Vue.use(vuex); import dialog_store from '../components/dialog_store.js';//引入某个store对象 export default new vuex.Store({ modules: { dialog: dialog_store } }) 

这里咱们引用了一个 dialog_store.js , 在这个 js 文件里咱们就能够单独写 dialog 组件的状态了 :

export default { state:{ show:false } }

作出这样的修改以后 , 咱们将以前咱们使用的 $store.state.show 通通改成 $store.state.dialog.show 便可。

若是还有其余的组件须要使用 vuex , 就新建一个对应的状态文件 , 而后将他们加入 store 文件夹下的 index.js 文件中的 modules 中。

modules: { dialog: dialog_store, other: other,//其余组件 } 

mutations

前面咱们提到的对话框例子 , 咱们对vuex 的依赖仅仅只有一个 $store.state.dialog.show 一个状态 , 可是若是咱们要进行一个操做 , 须要依赖不少不少个状态 , 那管理起来又麻烦了 !

mutations 登场 , 问题迎刃而解 :

export default { state:{//state show:false }, mutations:{ switch_dialog(state){//这里的state对应着上面这个state state.show = state.show?false:true; //你还能够在这里执行其余的操做改变state } } }

使用 mutations 后 , 原先咱们的父组件能够改成 :

<template> <div id="app"> <a href="javascript:;" @click="$store.commit('switch_dialog')">点击</a> <t-dialog></t-dialog> </div> </template> <script> import dialog from './components/dialog.vue' export default { components:{ "t-dialog":dialog } } </script>

使用 $store.commit('switch_dialog') 来触发 mutations 中的 switch_dialog 方法。

这里须要注意的是:

1. mutations 中的方法是不分组件的 , 假如你在 dialog_stroe.js 文件中的定义了
   switch_dialog 方法 , 在其余文件中的一个 switch_dialog 方法 , 那么
   $store.commit('switch_dialog') 会执行全部的 switch_dialog 方法。
2. mutations里的操做必须是同步的。

你必定好奇 , 若是在 mutations 里执行异步操做会发生什么事情 , 实际上并不会发生什么奇怪的事情 , 只是官方推荐 , 不要在 mutationss 里执行异步操做而已。

actions

多个 state 的操做 , 使用 mutations 会来触发会比较好维护 , 那么须要执行多个 mutations 就须要用 action 了:

export default { state:{//state show:false }, mutations:{ switch_dialog(state){//这里的state对应着上面这个state state.show = state.show?false:true; //你还能够在这里执行其余的操做改变state } }, actions:{ switch_dialog(context){//这里的context和咱们使用的$store拥有相同的对象和方法 context.commit('switch_dialog'); //你还能够在这里触发其余的mutations方法 }, } }

那么 , 在以前的父组件中 , 咱们须要作修改 , 来触发 action 里的 switch_dialog 方法:

<template> <div id="app"> <a href="javascript:;" @click="$store.dispatch('switch_dialog')">点击</a> <t-dialog></t-dialog> </div> </template> <script> import dialog from './components/dialog.vue' export default { components:{ "t-dialog":dialog } } </script>

使用 $store.dispatch('switch_dialog') 来触发 action 中的 switch_dialog 方法。

官方推荐 , 将异步操做放在 action 中。

getters

getters 和 vue 中的 computed 相似 , 都是用来计算 state 而后生成新的数据 ( 状态 ) 的。

仍是前面的例子 , 假如咱们须要一个与状态 show 恰好相反的状态 , 使用 vue 中的 computed 能够这样算出来 :

computed(){
    not_show(){
        return !this.$store.state.dialog.show; } } 

那么 , 若是不少不少个组件中都须要用到这个与 show 恰好相反的状态 , 那么咱们须要写不少不少个 not_show , 使用 getters 就能够解决这种问题 :

export default { state:{//state show:false }, getters:{ not_show(state){//这里的state对应着上面这个state return !state.show; } }, mutations:{ switch_dialog(state){//这里的state对应着上面这个state state.show = state.show?false:true; //你还能够在这里执行其余的操做改变state } }, actions:{ switch_dialog(context){//这里的context和咱们使用的$store拥有相同的对象和方法 context.commit('switch_dialog'); //你还能够在这里触发其余的mutations方法 }, } }

咱们在组件中使用 $store.state.dialog.show 来得到状态 show , 相似的 , 咱们可使用 $store.getters.not_show 来得到状态 not_show 。

注意 : $store.getters.not_show 的值是不能直接修改的 , 须要对应的 state 发生变化才能修改。

mapState、mapGetters、mapActions

不少时候 , $store.state.dialog.show 、$store.dispatch('switch_dialog') 这种写法又长又臭 , 很不方便 , 咱们没使用 vuex 的时候 , 获取一个状态只须要 this.show , 执行一个方法只须要 this.switch_dialog 就好了 , 使用 vuex 使写法变复杂了 ?

使用 mapState、mapGetters、mapActions 就不会这么复杂了。

以 mapState 为例 :

<template> <el-dialog :visible.sync="show"></el-dialog> </template> <script> import {mapState} from 'vuex'; export default { computed:{ //这里的三点叫作 : 扩展运算符 ...mapState({ show:state=>state.dialog.show }), } } </script> 

至关于 :

<template> <el-dialog :visible.sync="show"></el-dialog> </template> <script> import {mapState} from 'vuex'; export default { computed:{ show(){ return this.$store.state.dialog.show; } } } </script>

mapGetters、mapActions 和 mapState 相似 , mapGetters 通常也写在 computed 中 , mapActions 通常写在 methods中。

弄懂上面这些 , 你能够去看vuex文档了 , 应该能看懂了。