轉:http://www.cnblogs.com/ghost-xyx/p/6380689.html
Vuex 是一個專門為 Vue.js 應該程序開發的狀態管理模式,它類似於 Redux 應用於 React 項目中,他們都是一種 Flux 架構。相比 Redux,Vuex 更簡潔,學習成本更低。希望通過本文幫助還沒使用 Vuex 的同學快速上手。
注:本文針對 Vuex 2.0 的語法,目前通過 npm 默認下載的版本為 1.0+ ,想引入 2.0 版本可以通過 script 標簽引入。
<script src="https://unpkg.com/vuex@2.0.0"></script>
習慣使用 ES6 中 import 方法的可以暫時通過解構賦值的方式引入 Vuex 中的方法。
import { mapState, mapGetters } from 'Vuex';
// a.js
var sex="boy";
var echo=function(value){
console.log(value)
}
export {sex,echo}
//通過向大括號中添加sex,echo變量並且export輸出,就可以將對應變量值以sex、echo變量標識符形式暴露給其他文件而被讀取到
//不能寫成export sex這樣的方式,如果這樣就相當於export "boy",外部文件就獲取不到該文件的內部變量sex的值,因為沒有對外輸出變量接口,只是輸出的字符串。
// b.js
通過import獲取a.js文件的內部變量,{}括號內的變量來自於a.js文件export出的變量標識符。
import {sex,echo} from "./a.js"
console.log(sex) // boy
echo(sex) // boy
//替換為:
let { mapState, mapGetters } = Vuex;
Vuex 的核心內容主要就是 State、Getters、Mutations、Actions 這四部分,也非常好理解。
State
首先看如何申明一個 store(倉庫)
import Vue from 'Vue';
import Vuex from 'Vuex';
Vue.use(Vuex);
let store = new Vuex.Store({
state: {
stateA: 'a',
stateB: 'b',
stateC: 'c'
}
});
console.log(store.state.stateA); // a
在 store 中的 state 對象,可以理解為 Vue 實例中的 data 對象,它用來保存最基本的數據。
在 Vue 中獲取 store 中的狀態
let app = new Vue({ el: '#demo', template: `<h1>{{myState}}</h1>`, computed: { myState() { return store.state.stateA; } } });
最簡單的方式就是通過 Vue 中的計算屬性(computed) 來將 store 中的狀態映射為 Vue 的數據。但是當數據多時這種方法明顯效率過低,所以 Vuex 中提供了 mapState 方法用於批量映射 store 中的狀態。
首先必須在 Vue 中注冊 store 選項,這樣整個 store 就從根節點注冊到 Vue 下的每一個子組件里了。
import { mapState } from 'Vuex';
let app = new Vue({
el: '#demo',
store,
data: {
local: 'L'
},
computed: mapState({
stateA: state => state.stateA,
stateB: 'stateB',
stateC(state) {
return state.stateC + this.local;
}
})
});
上例中,a. 可以通過 ES6 中的箭頭函數進行數據的映射,b. 當計算屬性的名稱與 state 的屬性名一致時可能直接通過字符串賦值,c. 當需要引用上下文中的 data 屬性時,只能通過常規函數來使 this 生效。
如果所有計算屬性的名稱都與 state 一致,可以在 mapState 中以數組的方式進行映射。如果 Vue 中已經存在計算屬性,可以通過 ES6 的展開操作符 (...) 進行組合。
let app = new Vue({
el: '#demo',
store,
computed: {
local() {
return 'Local';
},
...mapState(['stateA', 'stateB', 'stateC'])
}
});
Getters
當需要對 store 中的數據進行處理,或者需要對處理后的數據進行復用,就可以使用 Getters 來處理,Getters 也可以理解為 Vue 中的計算屬性 (computed)。
let store = new Vuex.Store({
state: {
nowDate: new Date()
},
getters: {
dateFormat(state, getters) {
let date = state.nowDate;
return `${date.getFullYear()}-${date.getMonth()+1}-${date.getDate()} / ${date.getHours()}:${date.getMinutes()}`;
}
}
});
console.log('The time is now:', store.getters.dateFormat); // The time is now: 2017-2-10 / 17:28
getters 接收兩個參數,1. state、2. getters 本身,可以引用其他 getters。與 mapState 類似,Getters 也擁有 mapGetters 方法,用於批量映射。
let { mapGetters } from 'Vuex';
let comonent = {
computed: {
...mapGetters([
'nowDate'
])
}
};
Mutations
在 Vue 中,data 值是可以直接被更改的。但是在 Vuex 中,不能直接對 state 進行操作,唯一的方法就是提交 mutation。mutation 可以理解為 Vue 中的 method 事件,只不過調用 mutation 需要特別的方法。
let store = new Vuex.Store({
state: {
count: 0
},
mutations: {
addCount(state) {
state.count ++;
}
}
});
store.commit('addCount');
console.log(store.state.count); // 1
每一個 mutation 都有一個字符串的事件類型和一個回調函數。通常在回調函數中進行狀態更改,通過 store.commit 觸發事件。
傳參
// ...
mutations: {
addCount(state, n) {
state.count += n;
}
}
store.commit('addCount', 10);
這種方式有一個問題,一旦參數多了,就必須保證傳入的順序不能出錯,可讀性也很低。所以通常將參數以對象的形式傳入,同時 mutaion 的事件類型字符串也可以使用對象的形式傳入。
// ...
mutations: {
addCount(state, params) {
state.count += params.num;
}
}
store.commit('addCount', {
num: 10
});
store.commit({
type: 'addCount',
num: 10
});
這里有一個規則需要遵守,在 mutation 中更改 state 應該以新對象替換老對象,不要在直接原對象上直接修改。*熟悉 React 的朋友們應該知道,在使用 setState 更新狀態時也是同樣的規則。
通過 ES6 的展開操作符可以很容易的完成。
state.obj = { ...state.obj, newState: 123 };
在 Vue 組件中提交 mutaion
this.$store.commit('xxx');
在組件中可以通過上述方法提交 commit,不過 Vuex 提供了 mapMutations 方法用於將 mutation 映射到組件中的 method 中。與 mapState、mapGetters 相似,這里就不再贅述了。
import { mapMutations } from 'vuex'
const component = {
// ...
methods: {
...mapMutations([
'addCount' // 映射 this.addCount() 為 this.$store.commit('addCount')
]),
...mapMutations({
add: 'addCount' // 映射 this.add() 為 this.$store.commit('addCount')
})
}
}
mutation 必須是同步函數
我們先試着寫一個異步的 mutation ,看看會發生什么。
// ...
mutations: {
asyncAdd(state) {
setTimeout(() => {
state.count ++;
}, 2000);
}
}
store.commit('asyncAdd');
經測試,在 mutaion 里進行異步操作也是會生效的,2秒之后 state.count 確實發生改變。
那為什么還要強調 mutation 必須是同步的呢?因為在觸發 commit 之后,回調函數還沒有被調用,所以這次 mutation 的修改也是無法被調試工具所記錄的。
如何對 state 進行異步操作呢,就要使用下面的 Action 了。
Actions
Action 類似於 mutation,不同在於:
1. Action 不直接更改狀態,而是提交 mutation
2. Action 可以包含任何異步操作
const store = new Vuex.Store({
state: {
count: 0
},
mutations: {
addCount(state) {
state.count ++;
}
},
actions: {
asyncAdd(context) {
setTimeout(() => {
context.commit('addCount');
}, 2000);
}
}
})
Action 中的回調函數會接收一個上下文 context 對象,它包含了當前 store 中所有屬性和方法,但其不是 store 本身。你可以通過 context.commit 來提交 mutation,也可以通過 context.state 與 context.getters 來獲取 state 和 getters。
當需要多次調用 commit 時,可以使用 ES6 的語法對傳入的參數進行解構。
// ...
actions: {
asyncAdd({ commit }) {
commit('addCount');
}
}
分發 Action 與傳參
Action 是通過 store.dispatch 方法來觸發,傳參方式與 store.commit 類似。
store.dispatch('asyncAdd');
store.dispatch('asyncAdd', {
num: 10
});
store.dispatch({
type: 'asyncAdd',
num: 10
});
在 Vue 組件中分發 Action
this.$store.dispatch('xxx');
可以使用上述方式,同時 Vuex 中也提供了 mapActions 方法用於批量映射於組件中的 methods 中,與 mapMutations 類似。
import { mapActions } from 'vuex'
const component = {
// ...
methods: {
...mapActions([
'asyncAdd' // 映射 this.asyncAdd() 為 this.$store.dispatch('asyncAdd')
]),
...mapActions({
add: 'asyncAdd' // 映射 this.add() 為 this.$store.dispatch('asyncAdd')
})
}
}
組合 Actions
既然 Action 是異步行為,那我們可以使用 ES6 中的 Promise 對象進行組合。
const store = {
actions: {
asyncActionA({ commit }) {
return new Promise((resolve, reject) => {
setTimeout(() => {
commit('asyncAdd');
resolve();
}, 2000);
});
},
asyncActionB({ dispatch }, params) {
return dispatch('asyncActionA').then(() => {
console.log('Action complete at: ', params.date);
});
}
}
}
store.dispatch('asyncActionB', {
date: (new Date()).getTime() // 2秒后打印 Action complete at: xxxxxxxx (當前時間毫秒數)
});
ES6 中的箭頭函數
定義
定義一個箭頭函數很簡單,基本語法是:
([param] [, param]) => {
statements
}
param => expression
param 是參數,根據參數個數不同,分這幾種情況:
- () => { ... } // 零個參數用 () 表示;
- x => { ... } // 一個參數可以省略 ();
- (x, y) => { ... } // 多參數不能省略 ();
當然,和普通函數一樣,箭頭函數也可以使用 ES6 新增的「默認參數」和「剩余參數」( Firefox15+ 開始支持):
var func1 = (x = 1, y = 2) => x + y;
func1(); // 得到 3
var func2 = (x, ...args) => { console.log(args) };
func2(1,2,3); // 輸出 [2, 3]
箭頭函數允許多行語句或者單行表達式作為函數體。多行語句要用 {} 括起來;單行表達式不需要 {},並且會作為函數返回值:
x => { return x * x }; // 函數返回 x * x
x => x * x; // 同上一行
x => return x * x; // SyntaxError 報錯,不能省略 {}
x => { x * x }; // 合法,沒有定義返回值,返回 undefined
箭頭函數也是 JS 函數的一種,所以之前的 instanceof 和 typeof 依然可用:
var func1 = () => {};
func1 instanceof Function; // true
var func2 = () => {};
typeof func2; // "function"