vuex Action

2017-12-11  本文已影响0人  小冕

Action

Action类似于mutation,不同在于:

const store = new Vuex.store({
  state :{
    count:0
  },
  mutations:{
    increment(state){
      state.count++
    }
  },
  actions:{
    increment(context){
      context.commit('increment')
    }
  }
})

Action 函数接受一个与store实例具有相同方法和属性的context对象,因此你可以调用context.commit提交一个mutation,或者通过context.state和context.getters来获取state和getters。当我们在之后介绍到Modules时,你就知道context对象为什么不是store实例本身了。
实践中,我们会经常用到ES2015的参数解构来简化代码(特别是我们需要调用commit很多次的时候):

actions:{
  increment({commit}){
    commit('increment')
  }
}

分发Action

Action通过store.dispatch方法触发

store.dispatch('increment')

看上去感觉多此一举。我们直接分发mutation岂不更方便?实际上并非如此,还记得mutation必须同步执行这个限制么?Action就不受约束!我们可以在action内部执行异步操作:

actions:{
  incrementAsync({commit}){
    setTimeout(()=>{
      commit('increment')
    },1000)  
  }
}

Actions支持同样的载荷方式和对象方式进行分发:

//以载荷形式分发
store.dispath('incrementAsync',{
  amount:10
})
//以对象形式分发
store.dispatch({
  type:'incrementAsync',
  amount:10
})

来看一个更加实际的购物车示例,涉及到调用异步API和分发多重mutation:

actions:{
  checkout ({commit,state},products){
  //把当前购物车的物品备份起来
const savedCardtItems=[...state.cart.added]
  //发出结账请求,然后乐观地清空购物车
commit (types.CHECKOUT_REQUEST)
//购物API接受一个成功回调和一个失败回调
shop.buyProducts(
products,
//成功操作
()=>commit(types.CHECKOUT_SUCCESS),
//失败操作
()=>commit(types.CHECKOUT_FAILURE,savedCartItems)  
)
  }
}

*注意我们正在进行一系列的异步操作,并且通过提交mutation来记录action产生的副作用(即状态变更)。

在组件中分发Action

你在组件中使用this.$store.dispatch('xxx')分发action,或者使用mapActions辅助函数将组件的methods映射为store.dispatch调用(需要先在根节点注入store):

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')`
    })
  }
}

组合Action
Action通常是异步的,那么如何知道action什么时候结束呢?更重要的是,我们如何才能组合多个action,以处理更加复杂的异步流程?
首先,你需要明白store.dispatch可以处理被触发的action的处理函数返回的promise,并且store.dispatch仍旧返回Promise:

actions:{
  actionA({commit}){
    return new Promise((resolve,reject)=>{
      setTimeout(()=>{
        commit('someMutation')
        resolve()
      },1000)
    })
  }
}

现在你可以:

store.dispatch('actionA').then(()=>{
  //... 
})

在另外一个action中也可以:

actions:{
    //...
  actionB({dispatch,commit}){
     return dispatch('actionA'.then()=>{
        commit('someOtherMutation')
      })
  }
}

最后,如果我们利用async/await,我们可以如下组合action:

//假设getData()和getOtherData()返回的是Promise
actions:{
  async actionA ({commit}){
    commit('gotData',await getData())
  },
async actionB({dispatch,commit}){
   await dispatch ('actionA')//等待actionA完成
  commit('gotOtherData',await getOtherData())
} 
}

一个store.dispatch在不同模块中可以触发多个action函数。在这种情况下,只有当所有触发函数完成后,返回的Promise才会执行。
本文来自vuex 官网

上一篇 下一篇

猜你喜欢

热点阅读