Vuex教程第三講:Vuex旗下的Mutation--03

寫在前面

上一講,告訴了我們怎麼去使用倉庫 store 中的狀態數據。當然,光會用肯定還不夠,大部分的應用場景還得對這些狀態進行操控,那麼具體如何操控呢,這就是這一講要說的重點。

只有 mutation 能動 State

更改 Vuex 的 store 中的狀態的唯一方法是提交 mutation。Vuex 中的 mutation 非常類似於事件:每個 mutation 都有一個字符串的 事件類型 (type) 和 一個 回調函數 (handler)。這個回調函數就是我們實際進行狀態更改的地方,並且它會接受 state 作爲第一個參數:

const store = new Vuex.Store({
  state: {
    count: 1
  },
  mutations: {
    // 事件類型 type 爲 increment
    increment (state) {
      // 變更狀態
      state.count++
    }
  }
})

注意,我們不能直接 store.mutations.increment() 來調用,Vuex 規定必須使用 store.commit 來觸發對應 type 的方法:

store.commit('increment')

傳參

我們還可以向 store.commit 傳入額外的參數:

mutations: {
  increment (state, n) {
    state.count += n
  }
}

// 調用
store.commit('increment', 10)

mutation 中的這個額外的參數,官方給它還取了一個高大上的名字:載荷(payload)。說實話,第一次在文檔中看到這個標題「提交載荷」,真的就不想往下看了。

我們往往不是敗給了這些生澀的概念,而是敗給了自己內心的恐懼。

大多數情況下,載荷是一個對象,能夠讓我們更加易讀:

mutations: {
  increment (state, payload) {
    state.count += payload.amount
  }
}

關於提交的方式,有兩種:

// 1、把載荷和type分開提交
store.commit('increment', {
  amount: 10
})

// 2、整個對象都作爲載荷傳給 mutation 函數
store.commit({
  type: 'increment',
  amount: 10
})

當然,使用哪種方式沒有絕對的界限,純看自己的喜好,就我個人而言,還是比較傾向於使用第二種姿勢,放在一起更實在。

修改規則

簡單修改基礎類型的狀態數據倒是簡單,沒什麼限制,但是如果修改的是對象,那就要注意了。比如這個例子:

const store = new Vuex.Store({
  state: {
    student: {
      name: '小明',
      sex: '女'
    }
  }
})

這個時候,我們如果想要給 student 添加一個年齡 age: 18 屬性,怎麼辦呢?

是的,直接在 sex 下面把這個字段加上去不就行了,能這樣當然最好了。但是如果我們要動態的修改呢?那就得遵循 Vue 的規則了。如下:

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 事件的名字。

// 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 是怎麼調用的:store.commit('increment'),可以發現,這裏 commit 提交的方法 increment,是以字符串的形式代入的。如果項目小,一個人開發的話倒還好,但是項目大了,編寫代碼的人多了,那就麻煩了,因爲需要 commit 的方法一多,就會顯得特別混亂,而且以字符串形式代入的話,一旦出了錯,很難排查。

所以,對於多人合作的大項目,最好還是用常量的形式來處理 mutation,對於小項目倒是無所謂,想偷懶的隨意就好。

必須是同步函數

一定要記住,Mutation 必須是同步函數。爲什麼呢?

前面說了,我們之所以要通過提交 mutation 的方式來改變狀態數據,是因爲我們想要更明確地追蹤到狀態的變化。如果像下面這樣異步的話:

mutations: {
  someMutation (state) {
    api.callAsyncMethod(() => {
      state.count++
    })
  }
}

我們就不知道什麼時候狀態會發生改變,所以也就無法追蹤了,這與 Mutation 的設計初心相悖,所以強制規定它必須是同步函數。

store.commit('increment')
// 任何由 "increment" 導致的狀態變更都應該在此刻完成。
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章