Vuex 官网: https://vuex.vuejs.org/zh
Vuex 的最新版是 Vuex 4.x 【当前时间 2022-10】
Vue 3 使用 Vuex 4,而 Vue 2 使用 Vuex 3,本文记录的是 Vuex3 的使用总结,Vuex 3.x 文档
一、组件之间共享数据的方式:
父向子传值: v-bind 属性绑定,子向父传值: v-on 事件绑定
二、那么页面之间如何共享数据呢 ?这就需要使用到 vuex 了
vuex 可以实现多个组件中共享状态(数据)
官方解释: Vuex 是一个专为 Vue.js 应用程序开发的状态管理模式
换句话说,vuex 是实现组件全局状态(数据)管理的一种机制,可以方便的实现组件之间数据的共享
三、Vuex 术语
在 vuex 中,状态
指的是共享的数据,也就是 vuex 的 state 的值
四、使用 vuex 统一管理状态的好处
a. 高效的实现数据共享,提高开发效率 b. 集中管理共享的数据,易于开发和后期维护 c. 存储在 vuex 中的数据都是响应式的,能够实时保持数据与页面的同步
将 vuex 安装为 运行时依赖【本文章默认项目环境为 vue 脚手架】
vue 脚手架需要安装该依赖,而 uniapp 项目已经内置 vuex,无需安装即可直接使用
npm install vuex --save
创建文件: src/store/index.js, 文件内容如下:
import Vue from 'vue';
import Vuex from 'vuex';
// 1. 安装插件
Vue.use(Vuex)
// 2. 创建对象
const store = new Vuex.Store({
})
// 3. 导入 store 对象
export default store
在 main.js 中导入 store 对象,并将 store 对象挂载到 vue 实例上
import store from './store'
new Vue({
el: '#app',
store,
render: h => h(App)
})
多个界面修改 vuex 状态时,这个工具会对状态进行跟踪,当出现问题时,可以更好的调试错误
方法一:通过 vue 实例访问
因为将 vuex 挂载到了 vue 实例中,所以 vuex 的数据可以通过 vue 实例访问
this.$store.state
方法二:使用 mapState 函数将 vuex 数据映射为计算属性
// 1. 从 vuex 中按需导入 mapState 函数
import { mapState } from 'vuex';
// 2. 使用 mapState 函数将 vuex 数据映射为当前组件的计算属性 (computed)
export default {
computed: {
...mapState(['token', 'userInfo'])
}
}
// 也可以这样写
export default {
computed: mapState(['token', 'userInfo'])
}
使用场景: 当某一个数据需要经过一系列的操作后再返回时,可以使用 getters 处理
Getter 用于对 Store 中的数据进行加工处理形成新的数据,类似 Vue 的计算属性(computed),起到一个包装器的作用,当 Store 中的数据发生变化时, Getter 的数据也会跟着变化
getters 方法定义:
const store = new Vuex.Store({
state: {
counter: 6
},
getters: {
power(state) {
return state.counter * state.counter
}
}
})
调用 getters 的两种方式
方式一、使用 this.$store.getters.名称
调用 getters
// 调用方式
this.$store.getters.power
// 在组件模板中调用
{{ $store.getters.power }}
getters 的其他用法参考下方代码示例:
{{ $store.getters.more20Stu }}
{{ $store.getters.more20StuCount }}
{{ $store.getters.moreAgeStu(20) }}
const store = new Vuex.Store({
state: {
students: [
{ id: 1, name: "wang", age: 18 },
{ id: 2, name: "liang", age: 21 },
{ id: 3, name: "zhang", age: 30 },
],
},
getters: {
more20Stu(state) {
// 获取年龄大于20的
return state.students.filter(s => s.age > 20)
},
more20StuCount(state, getters) {
// 获取年龄大于20的个数
return getters.more20Stu.length
},
moreAgeStu(state) {
// 如果要传参数,需要返回一个函数
return age => {
return state.students.filter(s => s.age > age)
}
}
}
})
方式二、使用 mapGetters 将 getters 方法映射为当前组件的计算属性
// 1. 从 vuex 中按需导入 mapGetters 函数
import { mapGetters } from 'vuex';
// 2. 使用 mapGetters 函数将 getters 方法映射为当前组件的计算属性 (computed)
export default {
computed: {
...mapGetters(['power', 'total'])
}
}
vuex 的 state 数据更新的唯一方式: 提交 Mutation
mutations 用于变更 store 中的数据。只能通过 mutations 变更 store 数据,不能直接操作 store 数据,这种方式虽然操作起来繁琐一些,但是可以集中监控所有数据的变化
mutation 主要包括两部分: 事件类型 (type)、回调函数 (handler)
mutation 的定义方式: a. increment 称为事件类型,回调函数的第一个参数永远就是 state b. mutations 中的方法第二个参数被称为 mutations 的载荷 (payload)
{
state: {
counter: 1
},
mutations: {
mutations: {
increment(state) {
state.counter++
},
decrement(state, num) {
state.counter -= num
},
}
}
}
触发 mutation 的两种方式
方式一、使用 this.$store.commit
触发 mutations
// commit 的作用就是调用某个 mutation 函数
this.$store.commit("increment");//不需要参数
this.$store.commit("decrement", num);//传参
通过 commit 进行提交是一种普通的提交方式,vue 还提供了另外一种风格,它是一个包含 type 属性的对象
this.$store.commit({
type: "add",
num: 10,
age: 20,
});
此时要注意 mutation 中的方法的第二个参数的值,和普通提交方式可不一样
add(state, payload) {
console.log(payload) // {type: 'add', num: 10, age: 20}
}
方式二、使用 mapMutations
将 mutations 函数映射为当前组件的 methods 方法
// 1. 从 vuex 中按需导入 mapMutations 函数
import { mapMutations, } from 'vuex';
// 2. 使用 mapMutations 将 mutations 函数映射 methods 方法
export default {
methods: {
...mapMutations(['login', 'getUserInfo']),
}
}
vuex 要求 mutations 中的方法体内容必须是同步操作