Mutation

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

  1. import {createStore} from '@mpxjs/core'
  3. const store = createStore({
  4.   state: {
  5.     count: 1
  6.   },
  7.   mutations: {
  8.     increment (state) {
  9.       // 变更状态
  10.       state.count++
  11.     }
  12.   }
  13. })
  15. export default store

你不能直接调用一个 mutation handler。这个选项更像是事件注册：“当触发一个类型为 increment 的 mutation 时，调用此函数。”要唤醒一个 mutation handler，你需要以相应的 type 调用 store.commit 方法：

  1. store.commit('increment')

提交载荷（Payload）

你可以向 store.commit 传入额外的参数，即 mutation 的 载荷（payload）：

  1. // ...
  2. mutations: {
  3.   increment (state, n) {
  4.     state.count += n
  5.   }
  6. }
  1. store.commit('increment', 10)

在大多数情况下，载荷应该是一个对象，这样可以包含多个字段并且记录的 mutation 会更易读：

  1. // ...
  2. mutations: {
  3.   increment (state, payload) {
  4.     state.count += payload.amount
  5.   }
  6. }
  1. store.commit('increment', {
  2.   amount: 10
  3. })

Mutation 需遵守的响应规则

mpx内置store 中的状态是响应式的，那么当我们变更状态时，监视状态的 mpx页面或组件也会自动更新。这也意味着 mpx内置store 中的 mutation需要遵守一些注意事项：

  1. 无法感知属性的添加或删除，所以最好提前在你的 store 中初始化好所有所需属性。

  2. 当需要在对象上添加新属性时，你可以

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

Mutation 必须是同步函数

一条重要的原则就是要记住 mutation 必须是同步函数

在组件中提交 Mutation

你可以在组件中使用 store.commit('xxx') 提交 mutation，或者使用 store.mapMutations 辅助函数将组件中的 methods 映射为 store.commit 调用。

  1. import { createComponent } from '@mpxjs/core'
  2. import store from '../store'
  4. createComponent({
  5.   // ...
  6.   methods: {
  7.     ...store.mapMutations([
  8.       'increment', // 将 `this.increment()` 映射为 `store.commit('increment')`
  10.       // `mapMutations` 也支持载荷：
  11.       'incrementBy' // 将 `this.incrementBy(amount)` 映射为 `store.commit('incrementBy', amount)`
  12.     ]),
  13.     ...store.mapMutations({
  14.       add: 'increment' // 将 `this.add()` 映射为 `store.commit('increment')`
  15.     })
  16.   }
  17. })