Vuex学习笔记

Vuex 是什么?

** 官方解释:Vuex 是一个专为 Vue.js 应用程序开发的状态管理模式**。它采用集中式存储管理应用的所有组件的状态,并以相应的规则保证状态以一种可预测的方式发生变化。Vuex 也集成到 Vue 的官方调试工具 devtools extension,提供了诸如零配置的 time-travel 调试、状态快照导入导出等高级调试功能。

vuex其实就是用一个全局的变量保存了Vue项目中的所有的公共数据,类似与在前端这块放了一个数据库,大家都可以在这里存数据,删数据,改数据,读数据,是不是有点熟悉:增,删,改,查;不过这个全局的变量给他定义了一个固定的名字就叫:store(仓库),是不是很形象,而这个仓库里面装数据的袋子就是state,加工数据的机器就叫做:mutations,操作机器的工人就叫做:actions,把数据装起来取走的卡车就叫做:getters;
所以一个简单的vuex就是:

new vuex.store({
    state,
    mutations,
    actions,
    getters
})

Vuex 特点

  • Vuex 的状态存储是响应式的。当 Vue 组件从 store 中读取状态的时候,若 store 中的状态发生变化,那么相应的组件也会相应地得到高效更新。

  • 你不能直接改变 store 中的状态。改变 store 中的状态的唯一途径就是显式地提交(commit) mutations。这样使得我们可以方便地跟踪每一个状态的变化,从而让我们能够实现一些工具帮助我们更好地了解我们的应用。

为什么使用Vuex?

当你要开发一个大型的SPA应用的时候,会出现:多个视图公用一个状态、不同视图的行为要改变同一个状态的情况,遇到这种情况的时候就需要考虑使用Vuex了,它会把组件的共享状态抽取出来,当做一个全局单例模式进行管理,这样不管你何时何地改变状态,都会通知到使用该状态的组件做出相应的修改;

Vuex实例

import Vue from 'vue';
import Vuex form 'vuex';
Vue.use(Vuex);
const store = new Vuex.Store({
    state: {
        count: 0
    },
    mutations: {
        increment (state) {
            state.count++
        }
    }
})

这就是一个vuex的最简单实例,store就是组件中的共享状态,而改变状态的方法(其实是一个对象包含很多方法,但都是来改变store的)叫做:mutations;
需要特变注意的是只能通过mutations改变store的state的状态,不能通过store.state.count = 5;直接更改(其实可以更改,不建议这么做,不通过mutations改变state,状态不会被同步)。
使用store.commit方法触发mutations改变state:

store.commit('increment');
console.log(store.state.count)  // 1

这样一个简简单单的Vuex应用就实现了。

在Vue组件里使用Vuex

Vuex的状态获取是一个方法,当Vuex状态更新时,相应的Vue组件也要更新,所以Vue应该在计算属性(computed)获取state;

// Counter 组件
const Counter = {
    template: `<div>{{ count }}</div>`,
    computed: {
        count () {
            return store.state.count;
        }
    }
}

上面的例子是直接操作全局状态store.state.count,那么每个使用该Vuex的组件都要引入。为了解决这个,Vuex通过store选项,提供了一种机制将状态从根组件注入到每一个子组件中。

// 根组件
import Vue from 'vue';
import Vuex form 'vuex';
Vue.use(Vuex);
const app = new Vue({
    el: '#app',
    store,
    components: {
        Counter
    },
    template: `
        <div class="app">
            <counter></counter>
        </div>
    `
})

通过这种注入机制,就能在子组件Counter通过this.$store访问:

// Counter 组件
const Counter = {
    template: `<div>{{ count }}</div>`,
    computed: {
        count () {
            return this.$store.state.count
        }
    }
}
mapState函数
computed: {
    count () {
        return this.$store.state.count
    }
}

这样通过count计算属性获取同名state.count属性,是不是显得太重复了,我们可以使用mapState函数简化这个过程。

import { mapState } from 'vuex';
export default {
    computed: mapState ({
        count: state => state.count,
        countAlias: 'count',    // 别名 `count` 等价于 state => state.count
    })
}

还有更简单的使用方法:

computed: mapState([
  // 映射 this.count 为 store.state.count
  'count'
])
Getters对象

如果我们需要对state对象进行做处理计算,如下:

computed: {
    doneTodosCount () {
        return this.$store.state.todos.filter(todo => todo.done).length
    }
}

如果多个组件都要进行这样的处理,那么就要在多个组件中复制该函数。这样是很没有效率的事情,当这个处理过程更改了,还有在多个组件中进行同样的更改,这就更加不易于维护。

Vuex中getters对象,可以方便我们在store中做集中的处理。Getters接受state作为第一个参数:

const store = new Vuex.Store({
  state: {
    todos: [
      { id: 1, text: '...', done: true },
      { id: 2, text: '...', done: false }
    ]
  },
  getters: {
    doneTodos: state => {
      return state.todos.filter(todo => todo.done)
    }
  }
})

在Vue中通过store.getters对象调用。

computed: {
  doneTodos () {
    return this.$store.getters.doneTodos
  }
}

Getter也可以接受其他getters作为第二个参数:

getters: {
  doneTodos: state => {
      return state.todos.filter(todo => todo.done)
  },
  doneTodosCount: (state, getters) => {
    return getters.doneTodos.length
  }
}
mapGetters辅助函数

与mapState类似,都能达到简化代码的效果。mapGetters辅助函数仅仅是将store中的getters映射到局部计算属性:

import { mapGetters } from 'vuex'
export default {
  // ...
  computed: {
    // 使用对象展开运算符将 getters 混入 computed 对象中
    ...mapGetters([
      'doneTodosCount',
      'anotherGetter',
      // ...
    ])
  }
}

上面也可以写作:

computed: mapGetters([
      'doneTodosCount',
      'anotherGetter',
      // ...
    ])

所以在Vue的computed计算属性中会存在两种辅助函数:

import { mapState, mapGetters } form 'vuex';
export default {
    // ...
    computed: {
        mapState({ ... }),
        mapGetter({ ... })
    }
}
Mutations

更改Vuex的store中的状态的唯一方法就是mutations.
每一个mutation都有一个事件类型type和一个回调函数handler

const store = new Vuex.Store({
  state: {
    count: 1
  },
  mutations: {
    increment (state) {
      // 变更状态
      state.count++
    }
  }
})

调用mutation,需要通过store.commit方法调用mutation type:

store.commit('increment')
Payload 提交载荷

也可以向store.commit传入第二参数,也就是mutation的payload:

mutaion: {
    increment (state, n) {
        state.count += n;
    }
}
store.commit('increment', 10);

单单传入一个n,可能并不能满足我们的业务需要,这时候我们可以选择传入一个payload对象:

mutation: {
    increment (state, payload) {
        state.totalPrice += payload.price + payload.count;
    }
}
store.commit({
    type: 'increment',
    price: 10,
    count: 8
})
mapMutations函数

不例外,mutations也有映射函数mapMutations,帮助我们简化代码,使用mapMutations辅助函数将组件中的methods映射为store.commit调用。

import { mapMutations } from 'vuex'
export default {
  // ...
  methods: {
    ...mapMutations([
      'increment' // 映射 this.increment() 为 this.$store.commit('increment')
    ]),
    ...mapMutations({
      add: 'increment' // 映射 this.add() 为 this.$store.commit('increment')
    })
  }
}

注 Mutations必须是同步函数(即没有异步操作)。
如果我们需要异步操作,Mutations就不能满足我们需求了,这时候我们就需要Actions了。

Aciton对象

Action 类似于 mutation,不同在于:

  • Action 提交的是 mutation,而不是直接变更状态。
  • Action 可以包含任意异步操作(弥补了mutation不能有异步操作的不足)。
    让我们来注册一个简单的 action:
const store = new Vuex.Store({
      state: {
        count: 0
      },
      mutations: {
        increment (state) {
          state.count++
        }
      },
      actions: {
        increment (context) {      //此处的context具有与store实例相同的方法和属性
          context.commit('increment')
        }
      }
})

Action 函数接受一个与 store 实例具有相同方法和属性的 context 对象,因此你可以:

  • 调用 context.commit,提交一个 mutation;
  • 通过 context.statecontext.getters来获取 stategetters
    当我们在之后介绍到 Modules(https://vuex.vuejs.org/zh-cn/modules.html) 时,你就知道 context 对象为什么不是 store 实例本身了。
    实践中,我们会经常会用到 ES2015 的 参数解构 来简化代码(特别是我们需要调用 commit很多次的时候):
actions: {
    increment ({ commit }) {
      commit('increment')
    }
}
分发 Action

Action 通过 store.dispatch (与commit相对应)方法触发:

store.dispatch('increment')

乍一眼看上去感觉多此一举,我们直接分发 mutation 岂不更方便?实际上并非如此,还记得mutation 必须同步执行这个限制么?Action 就不受约束!我们可以在 action内部执行异步操作:

actions: {
    incrementAsync ({ commit }) {
        setTimeout(() => {  //模拟异步请求
            commit('increment')
        }, 1000)
    }
}

Actions 支持同样的载荷方式和对象方式进行分发:

// 以载荷形式分发
store.dispatch('incrementAsync', {
  amount: 10
})

// 以对象形式分发
store.dispatch({
  type: 'incrementAsync',
  amount: 10
})

来看一个更加实际的购物车示例,涉及到调用异步 API 和 分发多重 mutations:

actions: {
  checkout ({ commit, state }, products) {
    // 把当前购物车的物品备份起来
    const savedCartItems = [...state.cart.added]
    // 发出结账请求,然后乐观地清空购物车
    commit(types.CHECKOUT_REQUEST)
    // 购物 API 接受一个成功回调和一个失败回调
    shop.buyProducts(
      products,
      // 成功操作
      () => commit(types.CHECKOUT_SUCCESS),
      // 失败操作
      () => commit(types.CHECKOUT_FAILURE, savedCartItems)
    )
  }
}

注意我们正在进行一系列的异步操作,并且通过提交 mutation 来记录 action 产生的副作用(即状态变更)。

在组件中分发 Action

action为改变状态(数据)的方法,所以应该放在Vue组件的methods中;

你在组件中使用 this.$store.dispatch('xxx') 分发action,或者使用 mapActions 辅助函数将组件的 methods映射为 store.dispatch 调用(需要先在根节点注入 store):

import { mapActions } from 'vuex'

export default {
  // ...
  methods: {
    ...mapActions([
      'increment' // 映射 this.increment() 为 this.$store.dispatch('increment')
    ]),
    ...mapActions({
      add: 'increment' // 映射 this.add() 为 this.$store.dispatch('increment')
    })
  }
}
组合 Actions

Action 通常是异步的,那么如何知道 action 什么时候结束呢?更重要的是,我们如何才能组合多个 action,以处理更加复杂的异步流程?

首先,你需要明白 store.dispatch 可以处理被触发的action的回调函数返回的Promise,并且store.dispatch仍旧返回Promise

actions: {
  actionA ({ commit }) {
    return new Promise((resolve, reject) => {
      setTimeout(() => {
        commit('someMutation')
        resolve()
      }, 1000)
    })
  }
}

现在你可以在Vue组件中:

store.dispatch('actionA').then(() => {
  // ...
})

在另外一个 action 中也可以:

actions: {
  // ...
  actionB ({ dispatch, commit }) {
    return dispatch('actionA').then(() => {
      commit('someOtherMutation')
    })
  }
}

最后,如果我们利用 async / await 这个 JavaScript 即将到来的新特性,我们可以像这样组合 action:

// 假设 getData() 和 getOtherData() 返回的是 Promise

actions: {
  async actionA ({ commit }) {
    commit('gotData', await getData())
  },
  async actionB ({ dispatch, commit }) {
    await dispatch('actionA') // 等待 actionA 完成
    commit('gotOtherData', await getOtherData())
  }
}

一个 store.dispatch在不同模块中可以触发多个 action 函数。在这种情况下,只有当所有触发函数完成后,返回的 Promise 才会执行。

Modules

Vuex只能有一个单一的store对象,但是当应用变得庞大复杂的时候store就可能变得非常的臃肿;
所以为了解决这个问题Vuex增加了** 模块(module)**的概念,也就是说你可以在这个store对象里面再建子对象了,而且这些子对象都有: statemutationactiongetter嵌套子模块(再在子模块中从上至下进行同样方式的分割)

const moduleA = {
  state: { ... },
  mutations: { ... },
  actions: { ... },
  getters: { ... }
}

const moduleB = {
  state: { ... },
  mutations: { ... },
  actions: { ... }
}

const store = new Vuex.Store({
  modules: {
    a: moduleA,
    b: moduleB
  }
})

store.state.a // -> moduleA 的状态
store.state.b // -> moduleB 的状态
模块的局部状态

对于模块内部的 mutation 和 getter,接收的第一个参数是模块的局部状态对象。

const moduleA = {
  state: { count: 0 },//模块的局部状态对象
  mutations: {
    increment (state) {
      // 这里的 `state` 对象是模块的局部状态
      state.count++
    }
  },

  getters: {
    doubleCount (state) {
      return state.count * 2
    }
  }
}

同样,对于模块内部的 action,局部状态通过 context.state 暴露出来, 根节点状态则为 context.rootState:

const moduleA = {
  // ...
  actions: {
    incrementIfOddOnRootSum ({ state, commit, rootState }) {
      if ((state.count + rootState.count) % 2 === 1) {
        commit('increment')
      }
    }
  }
}

对于模块内部的 getter,根节点状态会作为第三个参数暴露出来:

const moduleA = {
  // ...
  getters: {
    sumWithRootCount (state, getters, rootState) {
      return state.count + rootState.count
    }
  }
}

文章里面代码直接使用的是文档里面的,感觉文档也不是十分的难理解,后面的命名空间,暂时没有整理,有时间看下后续整理吧,大家有什么问题可以在评论区一起讨论,;-)
** 文章部分引用:**
https://yeaseonzhang.github.io/2017/03/16/Vuex-%E9%80%9A%E4%BF%97%E7%89%88/
https://vuex.vuejs.org/zh-cn/modules.html

推荐阅读更多精彩内容

  • vuex 状态管理器 作为应用中所有组件的中央储存 只能以预定的方式去操作状态 把所有组件共享的状态抽取出来作为全...
    一只大椰子阅读 472评论 0 1
  • 安装 npm npm install vuex --save 在一个模块化的打包系统中,您必须显式地通过Vue.u...
    萧玄辞阅读 2,114评论 0 7
  • 上一章总结了 Vuex 的框架原理,这一章我们将从 Vuex 的入口文件开始,分步骤阅读和解析源码。由于 Vuex...
    你的肖同学阅读 1,062评论 3 16
  • Vuex是什么? Vuex 是一个专为 Vue.js应用程序开发的状态管理模式。它采用集中式存储管理应用的所有组件...
    萧玄辞阅读 2,135评论 0 6
  • VUEX 是一个状态管理模式,可以集中式存储和管理组件的状态。 组件使用store里面的state作数据展示,通过...
    Liberty寒风阅读 1,001评论 1 1