Mutation
更改Vuex的store中的状态的唯一方法是提交mutation。Vuex中的mutation非常类似于事件:每个mutation都有一个字符串的事件类型(type)和一个回调函数(handler)。这个回调函数就是我们实际进行状态更改的地方,并且它会接受state作为第一个参数。
const store=new Vuex.Store({
state:{
count:1
},
mutations:{
increment(state){
//变更状态
state.count++
}
}
})
不能直接调用一个mutation handler。这个选项更像是事件注册:“当触发一个类型为increment的mutation时,调用此函数。”要唤醒一个mutation handler,你需要以相应的type调用store.commit方法:
store.commit('increment')
提交载荷(Payload)
可以向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
})
当使用对象风格的提交方式,整个对象都作为载荷传给mutation函数,因此handler保持不变:
mutations:{
increment(state,payload){
state.count += payload.amount
}
}
Mutation 需遵守Vue的响应规则
既然Vuex 的store中的状态是响应式的,那么当我们变更状态时,监视状态的Vue组件也会自动更新。这意味着Vuex中的mutation也需要与使用Vue一样遵守一些注意事项:
1.最好提前在你的store中初始化好所有所需属性。
2.当需要在对象上添加新属性时,你应该:
- 使用Vue.set(obj,'newProp',123),或者
- 以新对象替换老对象。例如,利用stage-3的对象展开运算符我们可以这样写:
state.obj={...state.obj,nerProp: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必须是同步函数
一条重要原则就是要记住mutation必须是同步函数。
mutations:{
someMutation(state){
api.callAsyncMethod(()=>{
state.count++
})
}
}
现在想象,我们正在debug一个app并且观察devtool中的mutation日志。每一条mutation被记录,devtools都需要捕捉到前一状态和后一状态的快照。然而,在上面的例子中mutation中的异步函数中的回调让这不可能完成:因为当mutation触发的时候,回调函数还没有被调用,devtools不知道什么时候回调函数实际上被调用——实质上任何在回调函数中进行的状态的改变都是不可追踪的。
在组件中提交Mutation
你可以在组件中使用this.$store.commit('xxx')提交mutation,或者使用mapMutations辅助函数将组件中的methods映射为store.commitd调用(需要在根节点注入store)。
import {mapMutations} from 'vuex'
export default {
//...
methods:{
...mapMutations([
'increment',//将'this.increment()'映为‘this.$store.commint('increment')’
//mapMutations也支持载荷:
'incrementBy' //将‘this.incrementBy(amount)’映射为‘this.$store.commit('incremenrBY',amount)’
]),
...mapMutations({
add:'increment' //将'this.add()'映射为‘this.$store.commit('increment')’
})
}
}
下一步:Action
在mutation中混合异步调用会导致你的程序很难调试。例如,当你能调用了两个包含异步回调的mutation来改变状态,你怎么知道什么时候回调和哪个先回调呢?这就是为什么我们要区分两个概念。在vuex中,mutation都是同步事务:
store.commit('increment')
//任何由“increment”导致的状态变更都应该在此刻完成。
为了处理异步操作,让我们来看一看Action。
本文来源vuex官网