vuex 笔记

匿名 (未验证) 提交于 2019-12-03 00:21:02

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

如果您不打算开发大型单页应用,使用 Vuex 可能是繁琐冗余的。确实是如此――如果您的应用够简单,您最好不要使用 Vuex。一个简单的 global event bus 就足够您所需了。但是,如果您需要构建一个中大型单页应用,您很可能会考虑如何更好地在组件外部管理状态,Vuex 将会成为自然而然的选择


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

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

实例:

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

可以通过 store.state 来获取状态对象,以及通过 store.commit 方法触发状态变更:

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

再次强调,我们通过提交 mutation 的方式,而非直接改变 store.state.count,是因为我们想要更明确地追踪到状态的变化。这个简单的约定能够让你的意图更加明显,这样你在阅读代码的时候能更容易地解读应用内部的状态改变。此外,这样也让我们有机会去实现一些能记录每次状态改变,保存状态快照的调试工具。有了它,我们甚至可以实现如时间穿梭般的调试体验。

由于 store 中的状态是响应式的,在组件中调用 store 中的状态简单到仅需要在计算属性中返回即可。触发变化也仅仅是在组件的 methods 中提交 mutation。

实例:

<div id="app">   <p>{{ count }}</p>   <p>     <button @click="increment">+</button>     <button @click="decrement">-</button>   </p> </div>   // make sure to call Vue.use(Vuex) if using a module system  const store = new Vuex.Store({   state: {     count: 0   },   mutations: {     increment: state => state.count++,     decrement: state => state.count--   } })  new Vue({   el: '#app',   computed: {     count () {         return store.state.count     }   },   methods: {     increment () {       store.commit('increment')     },     decrement () {         store.commit('decrement')     }   } })

state

Vuex 通过 store 选项,提供了一种机制将状态从根组件“注入”到每一个子组件中(需调用 Vue.use(Vuex)):

const app = new Vue({   el: '#app',   // 把 store 对象提供给 “store” 选项,这可以把 store 的实例注入所有的子组件   store,   components: { Counter },   template: `     <div class="app">       <counter></counter>     </div>   ` })

通过在根实例中注册 store 选项,该 store 实例会注入到根组件下的所有子组件中,且子组件能通过 this.$store 访问到。

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

由于 Vuex 的状态存储是响应式的,从 store 实例中读取状态最简单的方法就是在计算属性中返回某个状态

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

Getter

Vuex 允许我们在 store 中定义“getter”(可以认为是 store 的计算属性)。就像计算属性一样,getter 的返回值会根据它的依赖被缓存起来,且只有当它的依赖值发生了改变才会被重新计算。

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)     }   } })

Getter 会暴露为 store.getters 对象,你可以以属性的形式访问这些值:

store.getters.doneTodos // -> [{ id: 1, text: '...', done: true }]

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

getters: {   // ...   doneTodosCount: (state, getters) => {     return getters.doneTodos.length   } }  ///调用 store.getters.doneTodosCount // -> 1 ///我们可以很容易地在任何组件中使用它:  computed: {   doneTodosCount () {     return this.$store.getters.doneTodosCount   } }

注意,getter 在通过属性访问时是作为 Vue 的响应式系统的一部分缓存其中的。

你也可以通过让 getter 返回一个函数,来实现给 getter 传参。在你对 store 里的数组进行查询时非常有用。

getters: {   // ...   getTodoById: (state) => (id) => {     return state.todos.find(todo => todo.id === id)   } }  store.getters.getTodoById(2) // -> { id: 2, text: '...', done: false }

注意,getter 在通过方法访问时,每次都会去进行调用,而不会缓存结果。

mapGetters 辅助函数

export default {   // ...   computed: {   // 使用对象展开运算符将 getter 混入 computed 对象中     ...mapGetters([       'doneTodosCount',       'anotherGetter',       // ...     ])   } } 如果你想将一个 getter 属性另取一个名字,使用对象形式:  mapGetters({   // 把 `this.doneCount` 映射为 `this.$store.getters.doneTodosCount`   doneCount: 'doneTodosCount' })

Mutation
更改 Vuex 的 store 中的状态的唯一方法是提交 mutation。Vuex 中的 mutation 非常类似于事件:每个 mutation 都有一个字符串的 事件类型 (type) 和 一个 回调函数 (handler)。这个回调函数就是我们实际进行状态更改的地方,并且它会接受 state 作为第一个参数

const store = new Vuex.Store({   state: {     count: 1   },   mutations: {     increment (state) {       // 变更状态       state.count++     }   } })
//你可以向 store.commit 传入额外的参数,即 mutation 的 载荷(payload):  // ... mutations: {   increment (state, n) {     state.count += n   } } store.commit('increment', 10)
//在大多数情况下,载荷应该是一个对象,这样可以包含多个字段并且记录的 mutation 会更易读:  // ... mutations: {   increment (state, payload) {     state.count += payload.amount   } } store.commit('increment', {   amount: 10 })  //提交 mutation 的另一种方式是直接使用包含 type 属性的对象:  store.commit({   type: 'increment',   amount: 10 })

既然 Vuex 的 store 中的状态是响应式的,那么当我们变更状态时,监视状态的 Vue 组件也会自动更新。这也意味着 Vuex 中的 mutation 也需要与使用 Vue 一样遵守一些注意事项:

1.最好提前在你的 store 中初始化好所有所需属性。

2.当需要在对象上添加新属性时,你应该

3.使用 Vue.set(obj, 'newProp', 123), 或者以新对象替换老对象。例如,利用 stage-3 的对象展开运算符我们可以这样写:

state.obj = { ...state.obj, newProp: 123 }

使用常量替代 Mutation 事件类型
使用常量替代 mutation 事件类型在各种 Flux 实现中是很常见的模式。这样可以使 linter 之类的工具发挥作用,同时把这些常量放在单独的文件中可以让你的代码合作者对整个 app 包含的 mutation 一目了然

// mutation-types.js export const SOME_MUTATION = 'SOME_MUTATION' // store.js import Vuex from 'vuex' import { SOME_MUTATION } from './mutation-types'  const store = new Vuex.Store({   state: { ... },   mutations: {     // 我们可以使用 ES2015 风格的计算属性命名功能来使用一个常量作为函数名     [SOME_MUTATION] (state) {       // mutate state     }   } })

在组件中提交 Mutation
你可以在组件中使用 this.$store.commit(‘xxx’) 提交 mutation,或者使用 mapMutations 辅助函数将组件中的 methods 映射为 store.commit 调用(需要在根节点注入 store)。

import { mapMutations } from 'vuex'  export default {   // ...   methods: {     ...mapMutations([       'increment', // 将 `this.increment()` 映射为 `this.$store.commit('increment')`        // `mapMutations` 也支持载荷:       'incrementBy' // 将 `this.incrementBy(amount)` 映射为 `this.$store.commit('incrementBy', amount)`     ]),     ...mapMutations({       add: 'increment' // 将 `this.add()` 映射为 `this.$store.commit('increment')`     })   } }

在 Vuex 中,mutation 都是同步事务

store.commit('increment') // 任何由 "increment" 导致的状态变更都应该在此刻完成。

Action
Action 类似于 mutation,不同在于:

Action 提交的是 mutation,而不是直接变更状态。
Action 可以包含任意异步操作。

const store = new Vuex.Store({   state: {     count: 0   },   mutations: {     increment (state) {       state.count++     }   },   actions: {     increment (context) {       context.commit('increment')     }   } })

Action 函数接受一个与 store 实例具有相同方法和属性的 context 对象,因此你可以调用 context.commit 提交一个 mutation,或者通过 context.state 和 context.getters 来获取 state 和 getters。

Action 通过 store.dispatch 方法触发:

store.dispatch('increment')

我们可以在 action 内部执行异步操作:

actions: {   incrementAsync ({ commit }) {     setTimeout(() => {       commit('increment')     }, 1000)   } }

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

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

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

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)     )   } }

Module
由于使用单一状态树,应用的所有状态会集中到一个比较大的对象。当应用变得非常复杂时,store 对象就有可能变得相当臃肿。Vuex 允许我们将 store 分割成模块(module)。每个模块拥有自己的 state、mutation、action、getter、甚至是嵌套子模块――从上至下进行同样方式的分割:

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 的状态
文章来源: vuex 笔记
标签
易学教程内所有资源均来自网络或用户发布的内容,如有违反法律规定的内容欢迎反馈
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!