官方文档:https://vuex.vuejs.org/zh/

介绍

Vue的单项数据流:
“单向数据流”理念的简单示意:
vuex - 图1
当我们的应用遇到多个组件共享状态时,单向数据流的简洁性很容易被破坏:

  • 多个视图依赖于同一状态。
  • 来自不同视图的行为需要变更同一状态。

Vuex 是一个专为 Vue.js 应用程序开发的状态管理模式。它采用集中式存储管理应用的所有组件的状态,并以相应的规则保证状态以一种可预测的方式发生变化。
image.png

  • 每一个 Vuex 应用的核心就是 store(仓库)。“store”基本上就是一个容器,它包含着你的应用中大部分的状态 (state)。Vuex 和单纯的全局对象有以下两点不同:
  • Vuex 的状态存储是响应式的。当 Vue 组件从 store中读取状态的时候,若 store中的状态发生变化,那么相应的组件也会相应地得到高效更新。
  • 你不能直接改变 store中的状态。改变 store中的状态的唯一途径就是显式地提交 (commit) mutation。这样使得我们可以方便地跟踪每一个状态的变化,从而让我们能够实现一些工具帮助我们更好地了解我们的应用。
  1. import Vue from 'vue'
  2. import Vuex from 'vuex'
  3. Vue.use(Vuex)
  4. const store = new Vuex.Store({
  5. state: {
  6. count: 0
  7. },
  8. mutations: {
  9. increment (state) {
  10. state.count++
  11. }
  12. }
  13. })
  14. //store.state 来获取状态对象,通过 store.commit 方法触发状态变更
  15. store.commit('increment')
  16. /输出结果
  17. console.log(store.state.count) // -> 1
  18. ==================================
  19. //挂载到Vue实例上(ES6)
  20. new Vue({
  21. el: '#app',
  22. store
  23. })
  24. //在方法上提交变更
  25. methods: {
  26. increment() {
  27. this.$store.commit('increment')
  28. console.log(this.$store.state.count)
  29. }
  30. }


action和mutation:

  • action 异步操作,mutation同步操作
  • action 提交的是 mutation,而不是直接变更状态

mapState

有时候需要获取多个状态,但是使用计算属性会调用多次,显得麻烦,这里借助mapState方法来获取state。 使用mapState需要引入该方法。

  1. computed: {
  2. ...mapState(['currentDeptNode', 'currUserInfo']),
  3. name() {
  4. return this.$store.state.name;
  5. }
  6. }

getter

相当于计算属性,过滤出来一些值

  1. getters: {
  2. //vuex中的计算属性,用于筛选数据
  3. getMessage(state) { // 获取修饰后的name,第一个参数state为必要参数,必须写在形参上
  4. return `hello${state.name}`;
  5. }
  6. //挂载
  7. <h2>{{$store.getters.getMessage}}</h2>

官方建议我们可以使用mapGetters去解构到计算属性中

mapGetters

mapGetters 辅助函数仅仅是将 store 中的 getter 映射到局部计算属性,当我们想在组件里面引入多个getter时,可以使用mapGetter:

  1. computed: {
  2. ...mapGetters(['getMessage']),
  3. // 也可以取别名
  4. ...mapGetters({
  5. msg: 'getMessage'
  6. })
  7. }


  1. const store = new Vuex.Store({
  2. state: {
  3. name: '张三',
  4. number: 0,
  5. },
  6. mutations: {
  7. setNumber(state) {
  8. state.number = 5;
  9. },
  10. setNumberIsWhat(state, payload) {
  11. // 增加一个带参数的mutations方法,并且官方建议payload为一个对象
  12. state.number = payload.number;
  13. }
  14. }
  15. })
  1. // 调用
  2. this.$store.commit('setNumberIsWhat', { number: 666 });

官方建议:使用mapMutations以代替this.$store.commit(‘XXX’)

mapMutations

Mutations里面的函数必须是同步操作

  1. methods: {
  2. ...mapMutations(['setNumberIsWhat']),
  3. //别名
  4. ...mapMutations({ setNumberIsAlias: 'setNumberIsWhat' }),
  5. },

  1. const store = new Vuex.Store({
  2. state: {
  3. name: '张三',
  4. number: 0,
  5. },
  6. mutations: {
  7. setNumberIsWhat(state, payload) {
  8. state.number = payload.number;
  9. },
  10. },
  11. actions: { // 增加actions属性
  12. setNum(content, payload) { // 增加payload参数
  13. return new Promise(resolve => {
  14. setTimeout(() => {
  15. content.commit('setNumberIsWhat', { number: payload.number });
  16. resolve();
  17. }, 1000);
  18. });
  19. }
  20. });
  21. // commit方法可以直接解构出来
  1. async mounted() {
  2. console.log(`旧值:${this.$store.state.number}`);
  3. await this.$store.dispatch('setNum', { number: 611 });
  4. console.log(`新值:${this.$store.state.number}`);
  5. },

官方建议:可以采用mapActions的方式

mapActions

  1. methods: {
  2. ...mapActions(['setNum']), // 就像这样,解构到methods中
  3. // 别名
  4. ...mapActions({ setNumAlias: 'setNum' }),
  5. },
  6. async mounted() {
  7. await this.setNum({ number: 123 }); // 直接这样调用即可
  8. },

模块化

  1. const moduleA = {
  2. state: () => ({ ... }),
  3. mutations: { ... },
  4. actions: { ... },
  5. getters: { ... }
  6. }
  7. const moduleB = {
  8. state: () => ({ ... }),
  9. mutations: { ... },
  10. actions: { ... }
  11. }
  12. const store = new Vuex.Store({
  13. modules: {
  14. a: moduleA,
  15. b: moduleB
  16. }
  17. })
  18. store.state.a // -> moduleA 的状态
  19. store.state.b // -> moduleB 的状态

默认情况下,模块内部的 action、mutation 和 getter 是注册在全局命名空间的——这样使得多个模块能够对同一 mutation 或 action 作出响应。
如果希望你的模块具有更高的封装度和复用性,你可以通过添加 namespaced: true 的方式使其成为带命名空间的模块。当模块被注册后,它的所有 getter、action 及 mutation 都会自动根据模块注册的路径调整命名。

  1. const store = new Vuex.Store({
  2. modules: {
  3. account: {
  4. namespaced: true,
  5. // 模块内容(module assets)
  6. state: () => ({ ... }), // 模块内的状态已经是嵌套的了,使用 `namespaced` 属性不会对其产生影响
  7. getters: {
  8. isAdmin () { ... } // -> getters['account/isAdmin']
  9. },
  10. actions: {
  11. login () { ... } // -> dispatch('account/login')
  12. },
  13. mutations: {
  14. login () { ... } // -> commit('account/login')
  15. }
  16. }
  17. }
  18. })