1、Vuex.store 的基本使用
Vuex 是一个专为 Vue.js 应用程序开发的状态管理模式，它采用集中式存储管理应用的所有组件的状态，并以相应的规则保证状态以一种可预测的方式发生变化。
Vuex 使用单一状态树，即用一个对象包含全部的应用层级状态，这也意味着，每个应用将仅仅包含一个 store 实例。
每一个 Vuex 应用的核心就是 store（仓库）。Vuex 的状态存储是响应式的。当 Vue 组件从 store 中读取状态的时候，若 store 中的状态发生变化，那么相应的组件也会相应地得到高效更新。你不能直接改变 store 中的状态。改变 store 中的状态的唯一途径就是显式地提交 (commit) mutation。这样使得我们可以方便地跟踪每一个状态的变化，从而让我们更方便地使用一些工具比如 devtools 来调试我们的应用。
1.1、创建 store
- 首先安装 Vue、Vuex，在一个 JS 文件中创建一个 store
//store.js import Vue from 'vue' import Vuex from 'vuex' Vue.use(Vuex); const store = new Vuex.Store({ state: { count: 0 }, getters: { age () { return 232 } }, actions: {}, mutations: { increment(state,) { state.count++; } } }) export default store;
- 然后在 main.js 中引入 store
// main.js import Vue from 'vue' import App from './App' import router from './router' import store from './store/store.js' Vue.config.productionTip = false new Vue({ el: '#app', router, store, components: { App }, template: '<App/>' })
通过 store 选项能将状态从根组件“注入”到每一个子组件中（前面需先调用 Vue.use(Vuex)）
在 main.js 文件中引入 store 后，该 store 实例会注入到根组件下的所有子组件中，其他组件就可以通过 this.$store 来访问这个 store 仓库了。
通过 this.$store.state 来访问数据、通过 this.$store.getters 来访问 getters 数据、通过 this.$store.commit('') 来调用 mutations 变更状态，通过调用 this.$store.dispatch('') 来触发 actions 调用 mutations。
2、Vuex.Store 的选项
2.1、state 选项
在组件中使用 store 中的 state，我们可以直接通过 this.$store.state 来使用，也可以通过将状态返回到组件中的计算属性中来使用，而且每当 $store.state.count 变化的时候, 都会重新求取计算属性。
2.1.1、mapState() 函数
我们可以使用 mapState 辅助函数来帮助我们将 state 返回到组件的计算属性中，减少我们的代码量。
mapState(nameSpace, Array | Object)，mapState 辅助函数的第一个参数可选，表示的是一个命名空间字符串（跟模块化有关），第二个参数可以是数组或者对象。函数最终返回一个对象，我们可以使用对象展开运算符将此对象插入到计算属性中。
import { mapState } from 'vuex'
<script>
export default {
data () {
return {}
},
computed: {
name () { return 'wen' },
...mapState([
'count' // 组件中的 this.count 则是 this.$store.state.count
])
}
}
</script>
// 或者使用对象作为参数
computed: {
...mapState({
count: state => state.count,
// 传字符串参数 'count' 等同于 `state => state.count`
countAlias: 'count',
// 为了能够使用 `this` 获取局部状态，必须使用常规函数
countPlusLocalState (state) {
return state.count + this.localCount
}
})
}
2.2、getters 选项
store 中的 getters 就像计算属性一样，getters 的返回值会根据它的依赖被缓存起来，且只有当它的依赖值发生了改变才会被重新计算。
Getter 接受 state 作为其第一个参数，Getter 也可以接受其他 getter 作为第二个参数。
const store = new Vuex.Store({ state: { age: 23 }, getters: { //接收一个参数 myAge: state => { return state.age + 2 }, //接收两个参数 myAge2: (state, getters) => { return getters.myAge + 2; } } })
在组件中可以通过 this.$store.getters 来访问 getters 中的数据。
你也可以通过让 getter 返回一个函数，来实现给 getter 传参。注意，getter 在通过方法访问时，每次都会去进行调用，而不会缓存结果
getters: { // 返回一个函数 getTodoById: (state) => (id) => { return state.todos.find(todo => todo.id === id) } } //组件中访问时通过函数的形式访问，传入参数 this.$store.getters.getTodoById(2)
2.2.1、mapGetters() 函数
类似于 mapState 辅助函数一样，可以通过 mapGetters 辅助函数将 store 中的 getter 映射到局部计算属性
import { mapGetters } from 'vuex'
export default {
computed: {
// 数组作为参数
...mapGetters([
'doneTodosCount',
'anotherGetter',
// ...
])
}
}
//对象作为参数
...mapGetters({
// 把 `this.doneCount` 映射为`this.$store.getters.doneTodosCount`
doneCount: 'doneTodosCount'
})
2.3、mutations 选项
更改 Vuex 的 store 中的状态的唯一方法是提交 mutation。mutation 必须是同步函数，即里面不能有异步的操作。要想异步操作，可以使用 actions。
mutation 接受 state 作为第一个参数。
const store = new Vuex.Store({ state: { count: 1 }, mutations: { increment (state) { // 变更状态 state.count++ } } })
在组件中通过 this.$store.commit('increment') 的形式来调用 mutation
mutation 可以接收其他数据作为其他参数，即载荷（payload）。一般来说，其他的参数可以作为对象传过去，这样更加简洁一点。
mutations: { increment (state, n) { state.count += n } } //调用时 this.$store.commit('increment', 10) // payload 是对象 mutations: { increment (state, payload) { state.count += payload.amount } } //调用时 store.commit('increment', { amount: 10 }) //或者此时可以使用对象风格进行提交 store.commit({ type: 'increment', amount: 10 })
2.3.1、mutation 往 state 的某个对象中添加属性
当 mutation 需要在 state 中的某个对象添加新属性时，不能直接添加，应该使用 Vue.set 方法，比如 Vue.set(obj, 'newProp', 123) 。或者是新生成一个对象，用新对象替换旧对象：state.obj = { ...state.obj, newProp: 123 }
state: { man: { name: 'wen' } }, mutations: { //添加属性 addProp (state) { Vue.set(state.man, 'age', 22) // 或者：state.man = Object.assgin({}, state.man, {age: 22}) } }
2.3.2、mapMutations() 函数
mapMutations() 辅助函数将 store 中的 mutations 映射到局部方法中。
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')`
})
}
}
2.4、actions 选项
Action 用来提交 mutation，由 mutation 来变更状态，Action 可以包含任意异步操作。
Action 函数接受一个与 store 实例具有相同方法和属性的 context 对象，可以调用 context.commit 提交一个 mutation，或者通过 context.state 和 context.getters 来获取 state 和 getters。
const store = new Vuex.Store({ state: { count: 0 }, mutations: { increment (state) { state.count++ } }, actions: { increment (context) { context.commit('increment') } // 下面的写法更加简洁 increment ({ commit }) { commit('increment') } } })
在组件内可以通过 this.$store.dispatch('') 来触发 action。
actions 可以接收额外的参数，额外的参数写成一个对象更加简洁。
//接收额外的参数 actions: { increment ({ commit }, n) { if(n >= 0){ commit('increment') } } } //用对象作为额外的参数 actions: { increment ({ commit }, payload) { if(payload.n >= 0){ commit('increment') } } } //此时的调用方式 this.$store.dispatch('increment', { amount: 10 }) // 以对象形式分发 store.dispatch({ type: 'incrementAsync', amount: 10 })
2.4.1、mapActions() 函数
可以使用 mapActions 辅助函数将 actions 映射到组件的 methods 中。
import { mapActions } from 'vuex'
export default {
methods: {
...mapActions([
'increment', // 将 `this.increment()` 映射为 `this.$store.dispatch('increment')`
// `mapActions` 也支持载荷：
'incrementBy' // 将 `this.incrementBy(amount)` 映射为 `this.$store.dispatch('incrementBy', amount)`
]),
...mapActions({
add: 'increment' // 将 `this.add()` 映射为 `this.$store.dispatch('increment')`
})
}
}
2.4.2、组合使用多个 action
我们可以组合多个 action以处理比较复杂的异步流程。
如果 action 中有异步操作，我们可以使用 promise或者 async/await 函数来更改状态。
也可以通过返回一个 promise来组合使用action，store.dispatch 可以处理 action 处理函数返回的 Promise，并且 store.dispatch 仍旧返回 Promise，由此我们可以在 store.dispatch() 后面接着写我们需要的操作。
actions: { actionA ({ commit }) { return new Promise((resolve, reject) => { setTimeout(() => { commit('someMutation') resolve() }, 1000) }) } //在另一个 action 中可以操作前面的 action 函数 resolve 出的数据 actionB ({ dispatch, commit }) { return dispatch('actionA').then(() => { commit('someOtherMutation') }) } } //在组件中 store.dispatch('actionA').then(() => { })
在 action 中使用 async/await
// 下面假设 getData() 和 getOtherData() 返回的是 Promise actions: { async actionA ({ commit }) { commit('gotData', await getData()) }, async actionB ({ dispatch, commit }) { await dispatch('actionA') // 等待 actionA 完成 commit('gotOtherData', await getOtherData()) } }