一、初识VueX
1.1 关于VueX
VueX
是适用于在Vue
项目开发时使用的状态管理工具。试想一下,如果在一个项目开发中频繁的使用组件传参的方式来同步data
中的值,一旦项目变得很庞大,管理和维护这些值将是相当棘手的工作。为此,Vue
为这些被多个组件频繁使用的值提供了一个统一管理的工具——VueX
。在具有VueX
的Vue
项目中,我们只需要把这些值定义在VueX
中,即可在整个Vue
项目的组件中使用。
1.2 安装
由于VueX
是在学习VueCli
后进行的,所以在下文出现的项目的目录请参照VueCli 2.x
构建的目录。
以下步骤的前提是你已经完成了Vue项目构建,并且已转至该项目的文件目录下。
- Npm安装
Vuex
npm i vuex -s
- 在项目的根目录下新增一个
store
文件夹,在该文件夹内创建index.js
此时你的项目的src
文件夹应当是这样的│ App.vue │ main.js │ ├─assets │ logo.png │ ├─components │ HelloWorld.vue │ ├─router │ index.js │ └─store index.js
1.3 使用
1.3.1 初始化store
下index.js
中的内容
import Vue from 'vue'
import Vuex from 'vuex'
//挂载Vuex
Vue.use(Vuex)
//创建VueX对象
const store = new Vuex.Store({
state:{
//存放的键值对就是所要管理的状态
name:'helloVueX'
}
})
export default store
1.3.2 将store
挂载到当前项目的Vue
实例当中去
打开main.js
import Vue from 'vue'
import App from './App'
import router from './router'
import store from './store'
Vue.config.productionTip = false
/* eslint-disable no-new */
new Vue({
el: '#app',
router,
store, //store:store 和router一样,将我们创建的Vuex实例挂载到这个vue实例中
render: h => h(App)
})
1.3.3 在组件中使用Vuex
例如在App.vue
中,我们要将state
中定义的name
拿来在h1
标签中显示
<template>
<div id='app'>
name:
<h1>{{ $store.state.name }}</h1>
</div>
</template>
或者要在组件方法中使用
...,
methods:{
add(){
console.log(this.$store.state.name)
}
},
...
注意,请不要在此处更改state
中的状态的值,后文中将会说明
1.4 安装Vue开发工具VueDevtools
在Vue项目开发中,需要监控项目中得各种值,为了提高效率,Vue提供了一款浏览器扩展——Vue Devtools
。
image
在学习VueX
时,更为需要使用该插件。关于该插件的使用可以移步官网,在此不再赘叙。
二、VueX中的核心内容
在VueX
对象中,其实不止有state
,还有用来操作state
中数据的方法集,以及当我们需要对state
中的数据需要加工的方法集等等成员。
成员列表:
- state: 存放状态(类似组件中的
data
,存放数据) - mutations:
state
成员操作(提交数据给data
中的方法,同步) - actions: 异步操作(提交数据给
mutations
后,通过mutations
再提交给data
的方法) - getters: 加工
state
成员给外界 (过滤data
中的数据,然后组件通过获取Getter
方法来获取过滤的方法) - modules: 模块化状态管理(解决单一状态树中应用复杂的情况)
2.1 VueX的工作流程
Vuex官网给出的流程图
首先,Vue
组件如果调用某个VueX
的方法过程中需要向后端请求时或者说出现异步操作时,需要dispatch
VueX中actions
的方法,以保证数据的同步。可以说,actions
的存在就是为了让mutations
中的方法能在异步操作中起作用。
如果没有异步操作,那么我们就可以直接在组件内提交状态中的mutations
中自己编写的方法来达成对state
成员的操作。注意,1.3.3节中有提到,不建议在组件中直接对state
中的成员进行操作,这是因为直接修改(例如:this.$store.state.name = 'hello'
)的话不能被Vue Devtools
所监控到。
最后被修改后的state
成员会被渲染到组件的原位置当中去。
2.2 mutations(同步操作)
mutations
是操作state
数据的方法的集合,比如对该数据的修改、增加、删除等等。
2.2.1 mutations
使用方法
mutations
方法都有默认的形参:
([state] [,payload])
state
是当前VueX
对象中的state
payload
是该方法在被调用时传递参数使用的
例如,我们编写一个方法,当被执行时,能把下例中的name值修改为"jack",我们只需要这样做(store
文件夹下的index.js
):
import Vue from 'vue'
import Vuex from 'vuex'
Vue.use(Vuex)
const store = new Vuex.store({
state:{
name:'helloVueX'
},
mutations:{
//es6语法,等同edit:funcion(){...}
edit(state){
state.name = 'jack'
}
}
})
export default store
而在组件中,我们需要这样去调用这个mutations
——例如在App.vue
的某个method
中:
this.$store.commit('edit')
2.2.2 mutations
传值
在实际生产过程中,会遇到需要在提交某个mutation
时需要携带一些参数给方法使用。
单个值提交时:
this.$store.commit('edit',15)
当需要多参提交时,推荐把他们放在一个对象中来提交:
this.$store.commit('edit',{age:15,sex:'男'})
接收挂载的参数:
edit(state,payload){
state.name = 'jack'
console.log(payload) // 15或{age:15,sex:'男'}
}
另一种提交方式
this.$store.commit({
type:'edit',
payload:{
age:15,
sex:'男'
}
})
2.2.3 增删state
中的成员
为了配合Vue
的响应式数据,我们在mutations
的方法中,应当使用Vue
提供的方法来进行操作。如果使用delete
或者xx.xx = xx
的形式去删或增,则Vue
不能对数据进行实时响应。
Vue.set
为某个对象设置成员的值,若不存在则新增
例如对state
对象中添加一个age
成员Vue.set(state,"age",15)
Vue.delete
删除成员
将刚刚添加的age
成员删除Vue.delete(state,'age')
2.3 actions(异步)
由于直接在mutations
方法中进行异步操作,将会引起数据失效。所以提供了actions
来专门进行异步操作,最终提交mutations
方法。
actions
中的方法有两个默认参数
context
上下文(相当于箭头函数中的this)对象payload
挂载参数
例如,我们在两秒中后执行2.2.2
节中的edit
方法
由于setTimeout
是异步操作,所以需要使用actions
actions:{
aEdit(context,payload){
setTimeout(()=>{
context.commit('edit',payload)
},2000)
}
}
在组件中调用:
this.$store.dispatch('aEdit',{age:15})
改进:
由于是异步操作,所以我们可以为我们的异步操作封装为一个Promise对象(有什么好处呢)
aEdit(context,payload){
return new Promise((resolve,reject)=>{
setTimeout(()=>{
context.commit('edit',payload)
resolve()
},2000)
})
}
2.4 getters
可以对state
中的成员加工后传递给外界
getters
中的方法有两个默认参数
- state 当前
VueX
对象中的状态对象 - getters 当前
getters
对象,用于将getters
下的其他getter
(如下例中的nameInfo
)拿来用
例如
getters:{
nameInfo(state){
return "姓名:"+state.name
},
fullInfo(state,getters){
return getters.nameInfo+'年龄:'+state.age
}
}
组件中调用
this.$store.getters.fullInfo
2.5 modules
当项目庞大,状态非常多时,可以采用模块化管理模式。Vuex
允许我们将 store
分割成模块(module
)。每个模块拥有自己的 state
、mutations
、actions
、getters
、甚至是嵌套子模块——从上至下进行同样方式的分割。
modules:{
a:{
state:{},
getters:{},
....
}
}
组件内调用模块a
的状态:
this.$store.state.a
而提交或者dispatch
某个方法和以前一样,会自动执行所有模块内的对应type
的方法:
this.$store.commit('editKey')
this.$store.dispatch('aEditKey')
2.5.1 模块的细节
-
模块中
mutations
和getters
中的方法接受的第一个参数是自身局部模块内部的state
modules:{ a:{ state:{key:5}, mutations:{ editKey(state){ state.key = 9 } }, .... } }
-
getters
中方法的第三个参数是根节点状态
modules:{ a:{ state:{key:5}, getters:{ getKeyCount(state,getter,rootState){ return rootState.key + state.key } }, .... } }
-
actions
中方法获取局部模块状态是context.state
,根节点状态是context.rootState
models:{ a:{ state:{key:5}, actions:{ aEidtKey(context){ if(context.state.key === context.rootState.key){ context.commit('editKey') } } }, .... } }
三、规范目录结构
如果把整个store
都放在index.js
中是不合理的,所以需要拆分。比较合适的目录格式如下:
store:.
│ actions.js
│ getters.js
│ index.js
│ mutations.js
│ mutations_type.js ##该项为存放mutaions方法常量的文件,按需要可加入
│
└─modules
Astore.js
对应的内容存放在对应的文件中,和以前一样,在index.js
中存放并导出store
。state
中的数据尽量放在index.js
中。而modules
中的Astore
局部模块状态如果多的话也可以进行细分。
四、其他
4.1 使用vuex or localstorage?
4.2 vuex中 this.$store.dispatch()
与 this.$store.commit()
方法的区别
区别总的来说他们只是存取方式的不同,两个方法都是传值给vuex的mutation改变state
this.$store.commit()
:同步操作,,写法:this.$store.commit(‘mutations方法名’,值)
this.$store.dispatch()
:含有异步操作,例如向后台提交数据,写法:this.$store.dispatch(‘actions方法名’,值)
4.3 vuex的存取值操作
commit: 同步操作
- 存储
this.$store.commit('changeValue',name)
(changeValue
是mutations
中的方法) - 取值
this.$store.state.changeValue
dispatch: 异步操作
- 存储
this.$store.dispatch('setlists',name)
(setlists
是actions
中的方法) - 取值
this.$store.getters.getlists
(getlists
是getters
中的方法?)