#### 只有 mutation 能動 State
> **更改 Vuex 的 store 中的狀態的唯一方法是提交 mutation**。Vuex 中的 mutation 非常類似于事件:每個 mutation 都有一個字符串的 事件類型 (type) 和 一個 回調函數 (handler)。這個回調函數就是我們實際進行狀態更改的地方,并且它會接受 state 作為第一個參數:
~~~cpp
const store = new Vuex.Store({
state: {
count: 1
},
mutations: {
// 事件類型 type 為 increment
increment (state) {
// 變更狀態
state.count++
}
}
})
~~~
注意,我們不能直接 `store.mutations.increment()` 來調用,Vuex 規定必須使用 `store.commit` 來觸發對應 type 的方法:
~~~bash
store.commit('increment')
~~~
#### 傳參
我們還可以向 store.commit 傳入額外的參數:
~~~csharp
mutations: {
increment (state, n) {
state.count += n
}
}
// 調用
store.commit('increment', 10)
~~~
mutation 中的這個額外的參數,官方給它還取了一個高大上的名字:**載荷(payload)**。說實話,第一次在文檔中看到這個標題**「提交載荷」**,真的就不想往下看了。
**我們往往不是敗給了這些生澀的概念,而是敗給了自己內心的恐懼。**
大多數情況下,載荷是一個對象,能夠讓我們更加易讀:
~~~swift
mutations: {
increment (state, payload) {
state.count += payload.amount
}
}
~~~
關于提交的方式,有兩種:
~~~go
// 1、把載荷和type分開提交
store.commit('increment', {
amount: 10
})
// 2、整個對象都作為載荷傳給 mutation 函數
store.commit({
type: 'increment',
amount: 10
})
~~~
當然,使用哪種方式沒有絕對的界限,純看自己的喜好,就我個人而言,還是比較傾向于使用第二種姿勢,放在一起更實在。
#### 修改規則
簡單修改基礎類型的狀態數據倒是簡單,沒什么限制,但是如果修改的是對象,那就要注意了。比如這個例子:
~~~csharp
const store = new Vuex.Store({
state: {
student: {
name: '小明',
sex: '女'
}
}
})
~~~
這個時候,我們如果想要給 `student` 添加一個年齡 `age: 18` 屬性,怎么辦呢?
是的,直接在 `sex` 下面把這個字段加上去不就行了,能這樣當然最好了。但是如果我們要動態的修改呢?那就得遵循 Vue 的規則了。如下:
~~~csharp
mutations: {
addAge (state) {
Vue.set(state.student, 'age', 18)
// 或者:
// state.student = { ...state.student, age: 18 }
}
}
~~~
以上就是給對象添加屬性的兩種方式,當然,對于已添加的對象,如果想修改具體值的話,直接更改就是,比如 `state.student.age=20` 即可。
至于為什么要這樣,之前我們了解過,因為 store 中的狀態是響應式的,當我們更改狀態數據的時候,監視狀態的 Vue 組件也會自動更新,所以 Vuex 中的 mutation 也需要與使用 Vue 一樣遵守這些規則。
#### 使用常量
就是使用常量來替代 mutation 事件的名字。
~~~dart
// mutation-types.js
export const SOME_MUTATION = 'SOME_MUTATION'
~~~
~~~jsx
// 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 是怎么調用的:`store.commit('increment')`,可以發現,這里 commit 提交的方法 `increment`,是以字符串的形式代入的。如果項目小,一個人開發的話倒還好,但是項目大了,編寫代碼的人多了,那就麻煩了,因為需要 commit 的方法一多,就會顯得特別混亂,而且以字符串形式代入的話,一旦出了錯,很難排查。
所以,對于多人合作的大項目,最好還是用常量的形式來處理 mutation,對于小項目倒是無所謂,想偷懶的隨意就好。
#### 必須是同步函數
一定要記住,**Mutation 必須是同步函數。**為什么呢?
前面說了,我們之所以要通過提交 mutation 的方式來改變狀態數據,是因為我們想要更明確地追蹤到狀態的變化。如果像下面這樣異步的話:
~~~jsx
mutations: {
someMutation (state) {
api.callAsyncMethod(() => {
state.count++
})
}
}
~~~
我們就不知道什么時候狀態會發生改變,所以也就無法追蹤了,這與 Mutation 的設計初心相悖,所以強制規定它必須是同步函數。
~~~bash
store.commit('increment')
// 任何由 "increment" 導致的狀態變更都應該在此刻完成。
~~~