理解 Vuex
1.1 Vuex是什么
概念:专门在 Vue中 实现集中式状态(数据)管理的一个Vue插件,对Vue应用中多个组件的共享状态进行集中式的管理(读/写),也是一种组件间的通信方式,且适用于任意组件间通信。
多组件共享数据——全局事件总线实现:
所有组件都能读到x,所有组件也都能修改 x
多组件共享数据——vuex 实现
1.2 什么时候使用Vuex
多个组件依赖同一状态(数据)
来自不同组件的行为需要变更同一状态(数据)
1.3 求和案例(纯Vue)
注意,对于复选框中的v-model的值为字符串,解决方法是:
为复选框的每一个选项的value前加冒号,加了冒号之后,引号里面的被视为表达式,而不是字符串,这样比较麻烦
为 v-model添加修饰符number,使收到的数据转换为数值
第一种解决为value添加 :
<select v-model="n">
<option :value="1">1</option>
<option :value="2">2</option>
<option :value="3">3</option>
</select>
第二种解决:为v-model添加修饰符 number
<select v-model.number="n">
<option value="1">1</option>
<option value="2">2</option>
<option value="3">3</option>
</select>
案例使用纯Vue的代码:
App.vue
<template>
<div>
<MyCount/>
</div>
</template>
<script>
import MyCount from './components/MyCount'
export default {
name: 'App',
components: {
MyCount,
},
}
</script>
MyCount.vue
<template>
<div>
<h1>当前求和为:{{sum}}</h1>
<select v-model.number="n">
<option value="1">1</option>
<option value="2">2</option>
<option value="3">3</option>
</select>
<button @click="increment">+</button>
<button @click="decrement">-</button>
<button @click="incrementOdd">当前求和为奇数再加</button>
<button @click="incrementWait">等一等再加</button>
</div>
</template>
<script>
export default {
name: 'MyCount',
data() {
return {
sum: 0, //当前的和
n: 1, //用户选择的数字
}
},
methods: {
increment() {
this.sum += this.n
},
decrement() {
this.sum -= this.n
},
incrementOdd() {
if(this.sum % 2) {
this.sum += this.n
}
},
incrementWait() {
setTimeout(()=> {
this.sum += this.n
}, 500)
}
},
}
</script>
<style>
button {
margin-left: 5px;
}
</style>
1.4 Vuex工作原理
state、actions、mutations都是对象数据类型
state、actions、mutations 都需要经过 store领导
dispatch、commit都是 store身上的
还可以直接通过 组件 到 mutations,不需要经过actions,此时直接调用 commit
vuex 核心概念和API:
state
vuex管理的状态对象
它应该是唯一的
actions
值是一个对象,包含多个响应用户动作的回调函数
通过 commit( )来触发 mutations中函数的调用,间接更新state
如何触发actions 中的回调?
在组件中使用 $store.dispatch('对应actions函数名', 数据)触发
可包含异步代码(定时器、ajax等)
代码示例:
const actions = {
zzz(context, value) {
context.commit('YYY',value) //YYY为对应mutations中的函数名
}
}
//也可以写为,下面使用了对象解构赋值
const actions = {
zzz({commit,state}, value) {
commit('YYY',value) //YYY为对应mutations中的函数名
}
}
mutations
值是一个对象,包含多个直接更新 state的方法
谁能调用 mutations中的方法?如何调用?
在actions中使用 : context.commit('对应的mutations方法名')触发
mutations中方法的特点:不能写异步代码,只能单纯的操作 state
示例代码:
const mutations = {
YYY(state,value) {
//更新state的某个属性
}
}
getters
值为一个对象,包含多个用于返回数据的函数
如何使用? $store.getters.xxx
示例代码
const getters = {
mmm(state) {
return state.msg + '!'
}
}
modules
包含多个 module
一个module 是一个 store的配置对象
与一个组件(包含有共享数据)对应
2.搭建 Vuex环境
安装 Vuex: npm i vuex@3
注意:vue2中,要用 vuex的3版本;vue3中,要用 vuex的4版本
目前用的是 vue2,所以要安装 vuex3,所以使用npm i vuex@3指定版本
引入并使用 Vue.use(vuex)
创建文件: src/store/index.js (建立一个store,store管理着actions,mutations,state,并且所有的组件都能看到 store,在引入并使用 vuex插件后,就可以为vm传入一个store配置项)
有两个选择:
在src文件夹中创建一个文件夹 vuex,并在该文件夹下创建 store.js文件
在src文件夹中创建一个文件夹 store,并在该文件夹下创建 index.js文件(官网推荐)
src/sotre/index.js
若main.js按照下面这样写:注意会报错:vuex的使用 必须要放到 store实例创建前
// 引入Vue
import Vue from 'vue'
// 引入 App
import App from './App'
// 引入插件
import vueResource from 'vue-resource'
import Vuex from 'vuex' //引入vuex
import store from './store/index'
// 关闭Vue的生产提示
Vue.config.productionTip = false
// 使用插件
Vue.use(vueResource)
Vue.use(Vuex)
new Vue({
el: '#root',
render: h => h(App),
store, //store: store的简写形式
// 安装全局事件总线
beforeCreate() {
Vue.prototype.$bus = this
}
})
注意:脚手架解析import时,先把所有的import语句按照代码编写顺序全部汇总到最上方,解析完成后再执行其他语句。
所以我们将vuex的使用 放到 src/store/index.js文件中,并放到 store实例创建之前,由于Vue.use(Vuex)放在index.js文件,所以也需要引入 Vue
src/store/index.js:
// 该文件用于创建Vuex中最为核心的 store
import Vue from 'vue'
// 引入 Vuex
import Vuex from 'vuex'
// 使用 vuex插件
Vue.use(Vuex)
// 准备 actions对象,用于响应组件中的动作
const actions = {}
// 准备 mutations对象,用于操作数据(state)
const mutations = {}
// 准备 state对象,用于存储数据
const state = {}
// 创建并暴露 store
export default new Vuex.Store({
actions, //actions: actions,的简写,属性名与属性值相同
mutations,
state
})
在vm中添加配置项 store(当vuex插件被引入并使用后,vm及vc身上可以使用配置项store)
main.js
// 引入Vue
import Vue from 'vue'
// 引入 App
import App from './App'
// 引入插件
import vueResource from 'vue-resource'
import store from './store/index'
// 关闭Vue的生产提示
Vue.config.productionTip = false
// 使用插件
Vue.use(vueResource)
new Vue({
el: '#root',
render: h => h(App),
store, //store: store的简写形式,传入 store配置项
// 安装全局事件总线
beforeCreate() {
Vue.prototype.$bus = this
}
})
3.求和案例(Vuex版)
3.1 vuex的基本使用
一个小技巧,mutations对象里的 函数/方法名用大写的字母表示 ,actions里的函数用小写的
1.初始化数据、配置actions、配置mutations,操作文件index.js
// 该文件用于创建Vuex中最为核心的 store
import Vue from 'vue'
// 引入 Vuex
import Vuex from 'vuex'
// 使用 vuex插件
Vue.use(Vuex)
// 准备 actions对象,用于响应组件中的动作
const actions = {
//响应组件中加的动作
jia(context,value){ //jia: function() {}的简写形式
context.commit('JIA',value)
}
}
// 准备 mutations对象,用于操作数据(state)
const mutations = {
//执行加
JIA(state,value){ //mutations对象里的 函数/方法名用大写的字母表示
//console.log('mutations中的JIA',state,value)
state.sum += value
}
}
// 准备 state对象,用于存储数据
//初始化数据
const state = {
sum: 0, //当前的和
}
// 创建并暴露 store
export default new Vuex.Store({
actions, //actions: actions,的简写,属性名与属性值相同
mutations,
state
})
2. 组件中读取vuex中的数据: $store.state.sum 若在模板中写不用加this,但是在js 中写必须加this
3. 组件中修改vuex中的数据:
$store.dispatch('actions中的方法名',数据) 或 $store.commit('mutations中的方法名',数据)
备注:若没有网络请求或其他业务逻辑,组件也可以越过 actions,即不写dispatch,直接编写commit
3.2 求和案例(Vuex版)
MyCount.vue
<template>
<div>
<h1>当前求和为:{{$store.state.sum}}</h1>
<select v-model.number="n">
<option value="1">1</option>
<option value="2">2</option>
<option value="3">3</option>
</select>
<button @click="increment">+</button>
<button @click="decrement">-</button>
<button @click="incrementOdd">当前求和为奇数再加</button>
<button @click="incrementWait">等一等再加</button>
</div>
</template>
<script>
export default {
name: 'MyCount',
data() {
return {
n: 1, //用户选择的数字
}
},
methods: {
increment() {
// this.$store.dispatch('jia',this.n)
this.$store.commit('JIA',this.n) //不经过 actions
},
decrement() {
// this.$store.dispatch('jian',this.n)
this.$store.commit('JIAN',this.n) //不经过 actions
},
incrementOdd() {
// if(this.$store.state.sum % 2) {
// this.$store.dispatch('jia',this.n)
// }
this.$store.dispatch('jiaOdd',this.n)
},
incrementWait() {
// setTimeout(()=> {
// this.$store.dispatch('jia',this.n)
// }, 500)
this.$store.dispatch('jiaWait',this.n)
}
},
}
</script>
<style>
button {
margin-left: 5px;
}
</style>
src/store/index.js
// 该文件用于创建Vuex中最为核心的 store
import Vue from 'vue'
// 引入 Vuex
import Vuex from 'vuex'
// 使用 vuex插件
Vue.use(Vuex)
// 准备 actions对象,用于响应组件中的动作
const actions = {
/* jia(context,value){ //jia: function() {}的简写形式
// console.log('actions中的jia被调用了')
// console.log(context,value);
context.commit('JIA',value)
},
jian(context,value){
context.commit('JIAN',value)
}, */
jiaOdd(context,value){
console.log('actions中的jiaOdd被调用了',context)
if(context.state.sum % 2) {
context.commit('JIA',value)
}
// console.log('处理了一些事情--jiaOdd')
// context.dispatch('demo1', value)
},
/* demo1(context,value){
console.log('处理了一些事情--demo1');
context.dispatch('demo2', value)
},
demo2(context,value){
console.log('处理了一些事情--demo2');
if(context.state.sum % 2) {
context.commit('JIA',value)
}
}, */
jiaWait(context,value){
console.log('actions中的jiaWait被调用了')
setTimeout(()=>{
context.commit('JIA',value)
},1000)
}
}
// 准备 mutations对象,用于操作数据(state)
const mutations = {
JIA(state,value){
console.log('mutations中的JIA')
state.sum += value
},
JIAN(store,value){
console.log('mutations中的JIAN')
store.sum -= value
}
}
// 准备 state对象,用于存储数据
const state = {
sum: 0, //当前的和
}
// 创建并暴露 store
export default new Vuex.Store({
actions, //actions: actions,的简写,属性名与属性值相同
mutations,
state
})
4. getters配置项
概念:当state中的数据需要经过加工后再使用时,可以使用 getters加工。
在index.js 中追加 getters配置
src/store/index.js
.....
// 准备 getters对象,用于state中的数据进行加工
const getters = {
bigSum(state){
return state.sum * 10 //需要用返回值返回
}
}
// 创建并暴露 store
export default new Vuex.Store({
actions, //actions: actions,的简写,属性名与属性值相同
mutations,
state,
getters
})
组件中读取数据: $store.getters.bigSum
state与getters像 data与computed的关系
5.四个map方法的使用(mapState、mapGetters、mapActions、mapMutations)
mapState方法:用于帮助我们映射 state中的数据为计算属性
//引入
import {mapState,mapGetters} from 'vuex'
.....
computed: {
//借助mapState生成计算属性,从state中读取数据(对象写法)
...mapState({sum:'sum',school:'school',subject:'subject'}),
//借助mapState生成计算属性,从state中读取数据(数组写法)
...mapState(['sum','school','subject']),
},
mapGetters方法:用于帮助我们映射 getters中的数据为计算属性
//引入
import {mapState,mapGetters} from 'vuex'
.....
computed: {
// 借助mapGetters 生成计算属性,从getters中读取数据(对象写法)
...mapGetters({bigSum: 'bigSum'})
// 借助mapGetters 生成计算属性,从getters中读取数据(数组写法)
...mapGetters(['bigSum'])
},
mapActions方法:用于帮助我们生成与 actions 对话的方法,即包含 $store.dispatch(xxx)的函数
methods:{
//靠mapActions生成:incrementOdd、incrementWait(对象形式)
...mapActions({incrementOdd:'jiaOdd',incrementWait:'jiaWait'})
//靠mapActions生成:incrementOdd、incrementWait(数组形式)
...mapActions(['jiaOdd','jiaWait'])
}
mapMutations方法:用于帮助我们生成与 mutations对话的方法,即包含$store.commit(xxx)的函数
//<button @click="increment(n)">+</button> //注意要在对应的函数中传参
//引入
import {mapMutations} from 'vuex'
.....
methods:{
//靠mapMutations生成对应的方法,方法中会调用 commit去联系mutations(对象形式)
...mapMutations({increment:'JIA',decrement:'JIAN'}),
//靠mapMutations生成:JIA、JIAN(对象形式)
...mapMutations(['JIA','JIAN']),
}
备注:mapActions 与 mapMutations 使用时,若需要传递参数需要在模板中绑定事件时传递好参数,否则参数是事件对象。
MyCount.vue:
<template>
<div>
<h1>当前求和为:{{sum}}</h1>
<!-- <h3>当前求和放大10倍为:{{$store.getters.bigSum}}</h3> -->
<h3>当前求和放大10倍为:{{bigSum}}</h3>
<h3>我在{{school}},学习{{subject}}</h3>
<select v-model.number="n">
<option value="1">1</option>
<option value="2">2</option>
<option value="3">3</option>
</select>
<button @click="JIA(n)">+</button>
<button @click="JIAN(n)">-</button>
<button @click="incrementOdd(n)">当前求和为奇数再加</button>
<button @click="incrementWait(n)">等一等再加</button>
</div>
</template>
<script>
import {mapState,mapGetters, mapMutations,mapActions} from 'vuex'
export default {
name: 'MyCount',
data() {
return {
n: 1, //用户选择的数字
}
},
computed: {
//靠程序员亲自去写计算属性
/* he() {
return this.$store.state.sum
},*/
//借助 mapState 生成计算属性,从state中读取数据(对象写法)
// ...mapState({he:'sum',xuexiao:'school',xueke:'subject'})
// 借助 mapState 生成计算属性,从state中读取数据(数组写法)
...mapState(['sum','school','subject']),
// 借助mapGetters 生成计算属性,从getters中读取数据(对象写法)
// ...mapGetters({bigSum: 'bigSum'})
// 借助mapGetters 生成计算属性,从getters中读取数据(数组写法)
...mapGetters(['bigSum'])
},
methods: {
// 程序员亲自写方法
/* increment() {
this.$store.commit('JIA',this.n) //不经过 actions
},
decrement() {
this.$store.commit('JIAN',this.n) //不经过 actions
}, */
//靠mapMutations生成对应的方法,方法中会调用 commit去联系mutations(对象形式)
// ...mapMutations({increment:'JIA',decrement:'JIAN'}),
//靠mapMutations生成对应的方法,方法中会调用 commit去联系mutations(数组形式)
...mapMutations(['JIA','JIAN']),
/* *********************************** */
/* incrementOdd() {
this.$store.dispatch('jiaOdd',this.n)
},
incrementWait() {
this.$store.dispatch('jiaWait',this.n)
}, */
// 靠mapActions生成对应的方法,方法中会调用 dispatch 去联系 actions(对象形式)
// ...mapActions({incrementOdd:'jiaOdd',incrementWait:'jiaWait'}),
// 靠mapActions生成对应的方法,方法中会调用 dispatch 去联系 actions(数组形式)
...mapActions(['jiaOdd','jiaWait'])
},
mounted() {
console.log(this.$store)
},
}
</script>
<style>
button {
margin-left: 5px;
}
</style>
6.vuex模块化 + (命名空间)namespace
目的:让代码更好维护,让多种数据分类更加明确。
修改 store.js, 为了解决不同模块命名冲突的问题且使数据进行分类从而更加明确,将不同模块的namespaced: true(默认为false),之后在各个组件中引入getter、actions、mutations,state时,需要加上所属的模块名
// 该文件用于创建Vuex中最为核心的 store
import Vue from 'vue'
// 引入 Vuex
import Vuex from 'vuex'
// 使用 vuex插件
Vue.use(Vuex)
// 求和功能相关的配置
const countAbout = {
namespaced: true, //开启命名空间
actions: {...},
mutations:{...},
state: {...},
getters: {
bigSum(state){
return state.sum * 10
}
}
}
// 人员管理相关的配置
const personAbout = {
namespaced: true, //开启命名空间
actions: {...},
mutations: {...},
state:{...},
getters: {...},
}
// 创建并暴露 store
export default new Vuex.Store({
modules: {
countAbout //countAbout:countAbout 的简写形式
personAbout
}
})
开启命名空间后,组件中读取state数据:
//方式一,自己直接读取
this.$store.state.countAbout.sum
//方式二,借助mapState读取
...mapState('countAbout',['sum','school','subject'])
开启命名空间后,组件中读取getters数据:
//方式一,自己直接读取
this.$store.getters['countAbout/sum'] //因为属性为带斜杠,所以不能使用点语法获取属性值
//故使用中括号 + 引号获取属性值
//方式二,借助mapGetters读取
...mapGetters('countAbout',['bigSum'])
开启命名空间后,组件中调用 dispatch:
//方式一,自己直接dispatch
this.$store.dispatch('personAbout/addPersonWang',person)
//方式二,借助mapActions
...mapActions('countAbout',{incrementOdd:'jiaOdd',incrementWait:'jiaWait'})
开启命名空间后,组件中调用 commit
//方式一,自己直接commit
this.$store.commit('personAbout/ADD_PERSON',person)
//方式二,借助mapMutations
...mapMutations('countAbout',{increment:'JIA',decrement:'JIAN'})
注意:还可将不同的数据模块放到单独的文件中,如 src/store/count.js,src/store/person.js
在文件中对其暴露,然后再在index.js文件中引入
如src/store/count.js
// 求和功能相关的配置
export default {
namespaced: true,
actions: {
jiaOdd(context,value){
console.log('actions中的jiaOdd被调用了',context)
if(context.state.sum % 2) {
context.commit('JIA',value)
}
},
jiaWait(context,value){
console.log('actions中的jiaWait被调用了')
setTimeout(()=>{
context.commit('JIA',value)
},1000)
}
},
mutations: {
JIA(state,value){
console.log('mutations中的JIA')
state.sum += value
},
JIAN(state,value){
console.log('mutations中的JIAN')
state.sum -= value
},
},
state: {
sum: 0, //当前的和
school: '尚硅谷',
subject: '前端',
},
getters: {
bigSum(state){
return state.sum * 10
}
}
}
src/store/person.js
// 人员管理相关的配置
import axios from 'axios'
import { nanoid } from 'nanoid'
export default {
namespaced: true,
actions: {
addPersonWang(context,value) {
if(value.name.indexOf('王') === 0) {
context.commit('ADD_PERSON',value)
}else {
alert('添加的人必须姓王')
}
},
addPersonServer(context){
axios.get('https://api.uixsj.cn/hitokoto/get?type=social').then(
response => {
console.log('请求成功了');
context.commit('ADD_PERSON',{id:nanoid(),name:response.data})
},
error => {
console.log('请求出错了',error.message);
}
)
}
},
mutations: {
ADD_PERSON(state,personObj) {
state.personList.unshift(personObj)
}
},
state: {
personList: [
{id:'001', name:'hhh'}
]
},
getters: {
firstPersonName(state){
return state.personList[0].name
}
}
}
src/store/index.js
// 该文件用于创建Vuex中最为核心的 store
import Vue from 'vue'
// 引入 Vuex
import Vuex from 'vuex'
// 使用 vuex插件
Vue.use(Vuex)
import countOptions from './count'
import personOptions from './person'
// 创建并暴露 store
export default new Vuex.Store({
modules: {
countAbout:countOptions,
personAbout:personOptions
}
})
MyCount.vue
<template>
<div>
<h1>当前求和为:{{sum}}</h1>
<!-- <h3>当前求和放大10倍为:{{$store.getters.bigSum}}</h3> -->
<h3>当前求和放大10倍为:{{bigSum}}</h3>
<h3>我在{{school}},学习{{subject}}</h3>
<h3 style="color:red;">MyPerson组件的总人数是:{{personList.length}}</h3>
<select v-model.number="n">
<option value="1">1</option>
<option value="2">2</option>
<option value="3">3</option>
</select>
<button @click="increment(n)">+</button>
<button @click="decrement(n)">-</button>
<button @click="incrementOdd(n)">当前求和为奇数再加</button>
<button @click="incrementWait(n)">等一等再加</button>
</div>
</template>
<script>
import {mapState,mapGetters, mapMutations,mapActions} from 'vuex'
export default {
name: 'MyCount',
data() {
return {
n: 1, //用户选择的数字
}
},
computed: {
// 借助 mapState 生成计算属性,从state中读取数据(数组写法)
...mapState('countAbout',['sum', 'school','subject']),
...mapState('personAbout',['personList']),
// 借助mapGetters 生成计算属性,从getters中读取数据(数组写法)
...mapGetters('countAbout',['bigSum'])
},
methods: {
//靠mapMutations生成对应的方法,方法中会调用 commit去联系mutations(数组形式)
...mapMutations('countAbout',{increment:'JIA',decrement:'JIAN'}),
// 靠mapActions生成对应的方法,方法中会调用 dispatch 去联系 actions(数组形式)
...mapActions('countAbout',{incrementOdd:'jiaOdd',incrementWait:'jiaWait'})
},
mounted() {
console.log(this.$store)
},
}
</script>
<style>
button {
margin-left: 5px;
}
</style>
MyPerson.vue
<template>
<div>
<h1>人员列表</h1>
<h3 style="color:red;">MyCount组件求和为:{{sum}}</h3>
<h3>列表中第一个人的名字是:{{firstPersonName}}</h3>
<input type="text" placeholder="请输入名字" v-model="name">
<button @click="add">添加</button>
<button @click="addWang">添加一个姓王的人</button>
<button @click="addPersonServer">添加一个人,名字随机</button>
<ul>
<li v-for="p in personList" :key="p.id">{{p.name}}</li>
</ul>
</div>
</template>
<script>
import {nanoid} from 'nanoid'
// import {mapState} from 'vuex'
export default {
name: 'MyPerson',
data(){
return {
name: ''
}
},
computed: {
personList(){
return this.$store.state.personAbout.personList
},
sum(){
return this.$store.state.countAbout.sum
},
// ...mapState(['personList','sum'])
firstPersonName(){
return this.$store.getters['personAbout/firstPersonName'] //因为属性为带斜杠,所以不能使用点语法获取属性值
}
},
methods: {
add() {
const personObj = {id:nanoid(),name:this.name}
// console.log(personObj)
this.$store.commit('personAbout/ADD_PERSON',personObj)
this.name = ''
},
addWang() {
const personObj = {id:nanoid(),name: this.name}
this.$store.dispatch('personAbout/addPersonWang',personObj)
this.name = ''
},
addPersonServer() {
this.$store.dispatch('personAbout/addPersonServer')
}
},
}
</script>