安裝vuex

npm install --save vuex

基本的vuex引入

// ./store/store.js
import Vue from 'vue';
import Vuex from 'vuex';

Vue.use(Vuex);

export const store = new Vuex.Store({
    state: {
       counter : 0
    },
    getters: {
       getCounter: state => { return state.counter; },
       getCounterStr: state => { return state.counter + ' counts'; }
    },
    mutations: {
       increment: state => { state.counter++; },
       decrement: state => { state.counter--; },
    },
    // actions
})

// ./main.js
import Vue from 'vue'
import App from './App.vue'
import {store} from './store/store'

new Vue({
  el: '#app',
  store,
  render: h => h(App)
})

state和getters及使用mapGetters配合ES6的object spread方式取store裡面state的值

import { mapGetters } from "vuex";
export default {
  computed: {
    ...mapGetters(["getCounter", "getCounterStr"]),
    counter(){
       return this.$store.getters.getCounter;
       // return this.$store.state.counter;
    }
  }
};

如果是用CLI2且要在專案裡面使用object spread這功能，我們會需要引入babel-preset-stage-2

npm install --save-dev babel-preset-stage-2

// .babelrc
{
  "presets": [["es2015", { "modules": false }], ["stage-2"]]
}

mutations同樣也有mapMutations可以使用

import { mapMutations } from "vuex";
export default {
  methods: {
    ...mapMutations(["increment", "decrement"])
  }
};

mutations不能在非同步的狀態下呼叫。假設 mutations裡面的increment是在setTimeout裡面，過1秒後才呼叫callback去改state.counter，如果同時有多個元件呼叫increment，那麼state.counter的狀態將會錯亂，所以mutations建議只在同步底下呼叫。這時候我們可以使用actions，而也是一個好的習慣不管同步非同步都是先call actions，然後在從actions裡面去commit mutations。

// actions
increment: context => {
  context.commit('increment');
},
decrement: ({commit}) => {
  commit('decrement');
},
asyncIncrement: ({commit}) => {
  setTimeout(() => {
  commit('increment');
  }, 1000);
},
asyncDecrement: ({commit}) => {
  setTimeout(() => {
  commit('decrement');
  }, 1000);
}

actions 回傳一個callback function帶著context參數 (如increment)，我們也可以用ES6的語法省略掉context，直接使用commit。當然 actions也有mapActions可以使用。

import { mapActions } from "vuex";
export default {
  methods: {
    ...mapActions (["increment", "decrement"])
  }
};

mutations, actions帶參數的寫法。payload可以是值也可以是物件

// mutations
increment: (state, payload) => { state.counter += payload; }

// actions
increment: ({commit}, payload) => { commit('increment'); }

// template
<button @click="increment(10)">Increment</button>
<!-- <button @click="increment({'by':10, 'duration': 1000})">Increment</button> -->

如果要使用two-way-binding如v-model，那原本的computed method可以做以下修改。

computed: {
    counter(){
       get(){
          return this.$store.getters.getCounter;
       },
       set(value){
          // pretend updateValue is a method inside actions
          this.$store.dispatch('updateValue', value);
       }
    }
  }

我們可以把new Vuex.Store({…})裡面的getters, mutations…等方法以模塊的方式引入，詳情參考這裡。

如果使用模塊方式引入，那在getters, mutations, actions…等裡面的方法名稱有可能重複，這時候可以使用namespacing的方式解決，詳情參考這裡。

Reference

• https://vuex.vuejs.org/zh/guide/
• https://github.com/vuejs/vuex/releases/tag/v2.1.0