一、什么是vuex?
vuex官方文档给出的解释是:vuex是一个专为vue.js应用程序开发的状态管理模式。
个人理解是全局状态管理,就是在state中定义一个数据后,在项目中任何一个组件里进行获取、修改。当在任何一个地方修改后可以得到全局的响应变更。(更简单的理解就是管理公共的数,修改一处,只要有关联的数据都得到修改)。
每一个 Vuex 应用的核心就是 store(仓库)。“store”基本上就是一个容器,它包含着你的应用中大部分的状态 (state)。
二、vuex安装和使用
1、安装:(这里只介绍vue-cli项目中的安装,其他安装可以去vuex官网查看https://vuex.vuejs.org/zh/installation.html)
在你的vue项目终端
npm install vuex --save回车即可安装
2、使用:在vue项目中src文件目录下新建一个名为store的文件夹,在文件夹里新建一个index.js文件,文件里面的内容如下:
import Vue from 'vue';
import Vuex from 'vuex';
Vue.use(Vuex);
const store = new Vuex.Store(); // 实例化vuex.store,可以传入对象
export default store
完成以上后在main.js里引入store,在全局注入一下,这样就可以在任何一个组件里使用this.$store了。main.js里代码如下:
import store from './store'; // ES6引入store
new vue({
el:'#app',
router,
store, // 全局使用store
template:'<App/>',
components:{App}
})
完成上面在回到store文件,在index.js中申明一个state常量并且赋值成对象,state中存放的是就是初始化的数据(官方解释是驱动应用的数据源;)。把state常量放入Vuex.Store对象中。代码如下:
import Vue from 'vue';
import Vuex from 'vuex';
Vue.use(Vuex);
const state = { // 初始化的数据(官方解释是驱动应用的数据源)。
showData:true,
changNum:0
}
const store = new Vuex.Store({ // 实例化vuex stort对象
state
});
export default store
完成以上后就可以使用this.$store.showData
或者this.$store.state.changNum
在项目中任何组件里获取showData和changNum的值。但是这不是理想的获取方式,vuex官方API提供了一个getter(可以认为是store的计算属性),和vue中计算属性computed一样,来实时监听state值的变化。Getter 接受 state 作为其第一个参数并且把他放入Vuex.Store对象中。代码如下:
import Vue from 'vue';
import Vuex from 'vuex';
Vue.use(Vuex);
const state = { // 全局用到的初始化的数据(官方解释是驱动应用的数据源)。
showData:true,
changNum:0
};
const getter = { // 用来监听state值的变化(实时状态)
isShow(state){ // 承载state中showData变化的值
return state.showData
},
getChangNum(){ // 承载state中changNum变化的值
return state.changNum
}
}
const store = new Vuex.Store({ // 实例化vuex stort对象
state,
getter
});
export default store
上面的state和getter的功能只是定义了初始值和承载初始值变化的作用。
要改变他们的值才是我们想要的,要改变数据我们就要用到mutations,mutations也是一个对象,这个对象可以存放改变state的初始值的方法,具体的用法就是给里面的方法传入参数state或者额外的参数,然后利用vue的双向数据驱动进行值的变化,同样定义好之后要把mutations放入Vue.Store中,代码如下:
import Vue from 'vue';
import Vuex from 'vuex';
Vue.use(Vuex);
const state = { // 全局用到的初始化的数据(官方解释是驱动应用的数据源)。
showData:true,
changNum:0
};
const getter = { // 用来监听state值的变化(实时状态)
isShow(state){ // 承载state中showData变化的值
return state.showData
},
getChangNum() = { // 承载state中changNum变化的值
return state.changNum
}
};
const mutations = { // 用来存放改变state初始值的方法
show(state){ // 自定义改变state初始值的方法,这里参数除了state还可以是有其他参数(变量或者对象)
state.showData = true;
},
hide(state){
state.showData = false;
},
newNum(state,sum){ // 这里参数除了state之外,额外传入了需要增加的值sum
state.changNum += sum;
}
};
const store = new Vuex.Store({
state,
getter,
mutations
});
export default store
此时你可以在组件中使用 this.$store.commit('show')
或者this.$store.commit('hide')
或者this.$store.commit('newNum',8)
提交 mutation,在别的组件里进行改变showData和changNum的值,但是这样也不是理想的改变值的方式;因为在vuex中,mutations里的方法都是同步事务,意思就是说:比如这里的一个this.$store('newNum',sum)
方法,两个组件里用执行得到的值,每次都是一样的,这样肯定不是理想的需求。
在vuex官方API还提供了一个actions,这个actions也是一个对象变量,最大的作用就是里面的action方法,可以包含任意异步操作,这里的方法是用来异步触发mutations里面的方法,actions里面自定义的函数接受一个context参数和要变化的形参,context与store实例具有相同的方法和属性,所有他可以执行context.commit(’’),然后也要放入Vuex.Store中,代码如下:
import Vue from 'vue';
import Vuex from 'vuex';
Vue.use(Vuex);
const state = { // 全局用到的初始化的数据(官方解释是驱动应用的数据源)。
showData:true,
changNum:0
};
const getter = { // 用来监听state值的变化(实时状态)
isShow(state){ // 承载state中showData变化的值
return state.showData
},
getChangNum() = { // 承载state中changNum变化的值
return state.changNum
}
};
const mutations = { // 用来存放改变state初始值的方法(同步)
show(state){ // 自定义改变state初始值的方法,这里参数除了state还可以是有其他参数(变量或者对象)
state.showData = true;
},
hide(state){
state.showData = false;
},
newNum(state,sum){ // 这里参数除了state之外,额外传入了需要增加的值sum
state.changNum += sum;
}
};
const actions = { // 存放用来异步触发mutations里面的方法,actions里面自定义的函数接受一个context参数和要变化的形参,context与store实例具有相同的方法和属性(异步)
hideData(context){ //自定义触发mutations里函数的方法,context与store 实例具有相同方法和属性
context.commit('hide');
},
showData(context){ //同上注释
context.commit('show')
},
getNewNum(context,num){ //同上注释,num为要变化的形参
context.commit('newNum',num)
}
};
const store = new Vuex.Store({
state,
getter,
mutations
});
export default store
此时在外部组件里全局执行actions里面方法的时候,只需要执行
this.$store.dispatch('hideData')
this.$store.dispatch('showData')
this.$store.dispatch('getNewNum',8) //8要变化的实参
此时就可以全局的改变showData和changNum的值了,如下代码需求是当页面跳转进来,根据链接里的参数来判断是否显示‘12345’这几个数字,代码如下:
<template>
<div class="goodsList">
<p v-if="isShow">12345</p>
</div>
</template>
<script>
export default {
data() {
return {
};
},
components: {
navBar
},
computed:{
isShow(){
return this.$store.getters.isShow;
}
},
watch: {
$route(to,from){ //跳转组件页面后,监听路由参数中对应的当前页面以及上一个页面
console.log(to,from)
if(to.query.id == 0){ // 当id==0 显示12345 否则不显示
this.$store.dispatch('showData');
} else {
this.$store.dispatch('hideData')
}
}
},
};
</script>
此时就基本完成vuex全局响应状态改变。
三、modules模块化 以及 组件中引入mapGetters、mapActions和mapStates的使用
在大多数的项目中,我们对于全局状态的管理并不仅仅一种情况的需求,有时有多方面的需求,比如写一个商城项目,你所用到的全局state可能是关于购物车这一块儿的也有可能是关于商品价格这一块儿的;像这样的情况我们就要考虑使用vuex中的 modules 模块化了
首先,在store文件夹下面新建一个modules文件夹,然后在modules文件里面建立需要管理状态的js文件,既然要把不同部分的状态分开管理,那就要把它们给分成独立的状态文件了,如下图:
而对应的store文件夹下面的index.js 里面的内容就直接改写成:
import Vue from 'vue';
import Vuex from 'vuex';
import footerStatus from './modules/footerStatus'
import collection from './modules/collection'
Vue.use(Vuex);
export default new Vuex.Store({
modules:{
footerStatus,
collection
}
});
相应的js,其中的 namespaced:true 表示当你需要在别的文件里面使用( mapGetters、mapActions 接下来会说 )时,里面的方法需要注明来自哪一个模块的方法:
//collection.js
const state={
collects:[], //初始化一个colects数组
};
const getters={
renderCollects(state){ //承载变化的collects
return state.collects;
}
};
const mutations={
pushCollects(state,items){ //如何变化collects,插入items
state.collects.push(items)
}
};
const actions={
invokePushItems(context,item){ //触发mutations里面的pushCollects ,传入数据形参item 对应到items
context.commit('pushCollects',item);
}
};
export default {
namespaced:true,//用于在全局引用此文件里的方法时标识这一个的文件名
state,
getters,
mutations,
actions
}
//showDataStatus.js
const state={ //要设置的全局访问的state对象
showData: true,
changNum:0
//要设置的初始属性值
};
const getters = { //实时监听state值的变化(最新状态)
isShow(state) { //承载变化的showData的值
return state.showData
},
getChangNum(){ //承载变化的changebleNum的值
return state.changNum
}
};
const mutations = {
show(state) { //自定义改变state初始值的方法,这里面的参数除了state之外还可以再传额外的参数(变量或对象);
state.showData= true;
},
hide(state) { //同上
state.showData= false;
},
newNum(state,sum){ //同上,这里面的参数除了state之外还传了需要增加的值sum
state.changNum+=sum;
}
};
const actions = {
hideData(context) { //自定义触发mutations里函数的方法,context与store 实例具有相同方法和属性
context.commit('hide');
},
showData(context) { //同上注释
context.commit('show');
},
getNewNum(context,num){ //同上注释,num为要变化的形参
context.commit('newNum',num)
}
};
export default {
namespaced: true, //用于在全局引用此文里的方法时标识这一个的文件名,如果希望你的模块具有更高的封装度和复用性,你可以通过添加 namespaced: true 的方式使其成为带命名空间的模块。当模块被注册后,它的所有 getter、action 及 mutation 都会自动根据模块注册的路径调整命名。
state,
getters,
mutations,
actions
}
这样一改就有了关于两个模块的state管理文件了 footerStatus.js和collection.js,现在你要运行当前的代码话,项目会报错!因为我们把上面的代码模块化分开了,引用的地方还没有改。接下来咱们一起来看看 mapState,mapGetters,mapActions的使用,首先 在需要用的 组件里面先导入 import {mapState,mapGetters,mapActions} from ‘vuex’;咱们先修正一下隐藏或显示页面底部的tabs选项卡(就是上面举的临时例子)的组件代码
<template>
<div id="app">
<p v-if="isShow">12345</p>
</div>
</template>
<script>
import {mapState,mapGetters,mapActions} from 'vuex'; //先要引入
export default {
name: 'App',
data(){
return {
}
},
computed:{
...mapState({ //这里的...是超引用,ES6的语法,意思是state里有多少属性值我可以在这里放多少属性值
isShow:state=>state.footerStatus.showData//注意这些与上面的区别就是state.footerStatus,
//里面定义的showData是指footerStatus.js里state的showData
}),
//你也可以用下面的mapGetters来获取isShow的值,貌似下面的更简洁
/*...mapGetters('footerStatus',{ //footerStatus指的是modules文件夹下的footerStatus.js模块
isShow:'isShow' //第一个isShow是我自定义的只要对应template里v-if="isShow"就行,
//第二个isShow是对应的footerStatus.js里的getters里的isShow
})*/
},
watch:{
$route(to,from){
if(to.query.id == 0){ // 当id==0 显示12345 否则不显示
this.$store.dispatch('footerStatus/showData') //这里改为'footerStatus/showData',
//意思是指footerStatus.js里actions里的showData方法
}else{
this.$store.dispatch('footerStatus/hideData') //同上注释
}
}
}
}
</script>
现在项目代码应该就不会报错了,好,最后咱们再来看一下mapActions的用法,实际上上面的this.$store.dispatch(‘footerStatus/showData’)已经算是一种执行相应模块的action里的方法了,但有时会牵扯的事件的触发及传值,那就会有下面的mapActions用法了,还记得上面的另一个模块collection.js吗?来看一下里面的actions中的方法结构:
const state={
collects:[], //初始化一个colects数组
};
const getters={
renderCollects(state){ //承载变化的collects
return state.collects;
}
};
const mutations={
pushCollects(state,items){ //如何变化collects,插入items
state.collects.push(items)
}
};
const actions={
invokePushItems(context,item){ //触发mutations里面的pushCollects ,传入数据形参item 对应到items
context.commit('pushCollects',item);
}
};
需要传值来实时变动state.collects里的数据,那肯定要在执行它的地方进行传值了,所以下面用到它的地方我们用了个@click来执行这个invokePushItems方法了,并且传入相应的对象数据item,如下:
<template>
<div id="shopcart">
<section>
<div class="joinStateHead">
<span class="h3">商品1</span>
<span class="joinStatus" @click="invokePushItems(item)">加入购物车</span>
</div>
</section>
</div>
</template>
<script>
import { mapActions } from 'vuex';
export default {
data(){
return{
msg:'',
item:{
id:'01',
productName:'小米6',
price:'2500元'
}
}
},
mounted() {
},
methods: {
...mapActions('collection',[ // //collection是指modules文件夹下的collection.js
'invokePushItems' //collection.js文件中的actions里的方法,在上面的@click中执行并传入实参
])
},
components:{
}
}
</script>
这样一来,在这个组件里面操作的 collecttion.js 中的state的数据,在其他的任何的一个组件里面都会得到相应的更新变化了,获取状态的页面代码如下:
<template>
<div class="goodsList">
<nav-bar title="购物车"></nav-bar>
<ul>
<li v-for="(val,index) in arrList" :key="index">
<h5>{{val.productName}}</h5>
<p>{{val.price}}</p>
</li>
</ul>
</div>
</template>
<script>
import {mapState,mapGetters,mapActions} from 'vuex';
export default {
data() {
return {
}
},
computed:{
// ...mapState({ //用mapState来获取collection.js里面的state的属性值
// arrList:state=>state.collection.collects
// }),
...mapGetters('collection',{ //用mapGetters来获取collection.js里面的getters
arrList:'renderCollects'
})
}
}
</script>
下图是结果:
以上就是vuex常用的知识点。
总结:vuex的核心概念就是
State: 初始化的数据(官方解释是驱动应用的数据源)。
Getter: 用来监听state值的变化(实时状态)
Mutation: 用才存放改变state初始值的方法
Action: 存放用来异步触发mutations里面的方法
Module: 模块化使用vuex
主要用到
mapGetters
mapActions
mapStates