利用這種數(shù)據(jù)管理模式在組件外部集中管理狀態(tài),可方便構(gòu)建一個(gè)中大型單頁(yè)應(yīng)用
chameleon-store 提供集中管理數(shù)據(jù)的能力。
這是一個(gè)簡(jiǎn)單的例子:
Chameleon 內(nèi)置 store 并不限制你的代碼結(jié)構(gòu)。但是,它規(guī)定了一些需要遵守的規(guī)則:
只要你遵守以上規(guī)則,如何組織代碼隨你便。如果你的 store 文件太大,只需將 action、mutation 和 getter 分割到單獨(dú)的文件。
對(duì)于大型應(yīng)用,我們會(huì)希望把 CML 相關(guān)代碼分割到模塊中。下面是項(xiàng)目結(jié)構(gòu)示例:
├── app
├── assets
├── pages # 頁(yè)面
│ └── ...
├── components # 組件
│ ├── c-todoitem
│ └── ...
└── store
├── action-types.js # 定義 actions 的類型
├── actions.js # 根級(jí)別的 actions
├── getter-types.js # 定義 getters 的類型
├── getters.js # 根級(jí)別的 getters
├── index.js # 我們組裝模塊并導(dǎo)出 store 的地方
├── mutation-types.js # 定義 mutations 的類型
├── mutations.js # 根級(jí)別的 mutation
├── state.js # 組件初始狀態(tài)數(shù)據(jù)
└── modules # 子模塊
├── ...
“store”基本上就是一個(gè)容器,它包含著你的應(yīng)用中大部分的狀態(tài) (state)。store 和單純的全局對(duì)象有以下兩點(diǎn)不同:
創(chuàng)建 store,并且提供一個(gè)初始 state 對(duì)象和一些 mutation:
import createStore from 'chameleon-store';
const store = createStore({
state: {
count: 0,
},
mutations: {
increment(state) {
state.count++;
},
},
});
export default store;
通過(guò) store.state 來(lái)獲取狀態(tài)對(duì)象,以及通過(guò) store.commit 方法觸發(fā)狀態(tài)變更:
store.commit('increment');
console.log(store.state.count); // -> 1
再次強(qiáng)調(diào),我們通過(guò)提交 mutation 的方式,而非直接改變 store.state.count,是因?yàn)槲覀兿胍鞔_地追蹤到狀態(tài)的變化。這個(gè)簡(jiǎn)單的約定能夠讓你的意圖更加明顯,這樣你在閱讀代碼的時(shí)候能更容易地解讀應(yīng)用內(nèi)部的狀態(tài)改變。此外,這樣也讓我們有機(jī)會(huì)去實(shí)現(xiàn)一些能記錄每次狀態(tài)改變,保存狀態(tài)快照的調(diào)試工具。有了它,我們甚至可以實(shí)現(xiàn)如時(shí)間穿梭般的調(diào)試體驗(yàn)。
由于 store 中的狀態(tài)是響應(yīng)式的,在組件中調(diào)用 store 中的狀態(tài)簡(jiǎn)單到僅需要在計(jì)算屬性中返回即可。觸發(fā)變化也僅僅是在組件的 methods 中提交 mutation。
接下來(lái),我們將會(huì)更深入地探討一些核心概念。讓我們先從State概念開(kāi)始。
類似 Vuex 數(shù)據(jù)理念和語(yǔ)法規(guī)范,chameleon-store 主要有以下核心概念:
chameleon-store 用一個(gè)對(duì)象就包含了全部的應(yīng)用層級(jí)狀態(tài)。單一狀態(tài)樹(shù)讓我們能夠直接地定位任一特定的狀態(tài)片段,在調(diào)試的過(guò)程中也能輕易地取得整個(gè)當(dāng)前應(yīng)用狀態(tài)的快照。
單狀態(tài)樹(shù)和模塊化并不沖突——在后面的章節(jié)里我們會(huì)討論如何將狀態(tài)和狀態(tài)變更事件分布到各個(gè)子模塊中。
那么我們?nèi)绾卧?CML 組件中展示狀態(tài)呢?由于 CML 內(nèi)置的 store 的狀態(tài)存儲(chǔ)是響應(yīng)式的,從 store 實(shí)例中讀取狀態(tài)最簡(jiǎn)單的方法就是在計(jì)算屬性中返回某個(gè)狀態(tài):
import store from '../store';
// 創(chuàng)建一個(gè) Counter 組件
const Counter = {
computed: {
count() {
return store.state.count;
},
},
};
每當(dāng) store.state.count 變化的時(shí)候, 都會(huì)重新求取計(jì)算屬性,并且觸發(fā)更新相關(guān)聯(lián)的 DOM。
當(dāng)一個(gè)組件需要獲取多個(gè)狀態(tài)時(shí)候,將這些狀態(tài)都聲明為計(jì)算屬性會(huì)有些重復(fù)和冗余。為了解決這個(gè)問(wèn)題,我們可以使用 mapState 輔助函數(shù)幫助我們生成計(jì)算屬性,讓你少按幾次鍵:
// 在單獨(dú)構(gòu)建的版本中輔助函數(shù)為 CML 內(nèi)置的store.mapState
import store from '../store';
class Index {
// ...
computed = store.mapState({
// 箭頭函數(shù)可使代碼更簡(jiǎn)練
count: (state) => state.count,
// 傳字符串參數(shù) 'count' 等同于 `state => state.count`
countAlias: 'count',
// 為了能夠使用 `this` 獲取局部狀態(tài),必須使用常規(guī)函數(shù)
countPlusLocalState(state) {
return state.count + this.localCount;
},
});
}
export default new Index();
當(dāng)映射的計(jì)算屬性的名稱與 state 的子節(jié)點(diǎn)名稱相同時(shí),我們也可以給 mapState 傳一個(gè)字符串?dāng)?shù)組。
import store from '../store';
class Index {
computed = store.mapState([
// 映射 this.count 為 store.state.count
'count',
]);
}
export default new Index();
mapState 函數(shù)返回的是一個(gè)對(duì)象。我們?nèi)绾螌⑺c局部計(jì)算屬性混合使用呢?通常,我們需要使用一個(gè)工具函數(shù)將多個(gè)對(duì)象合并為一個(gè),以使我們可以將最終對(duì)象傳給 computed 屬性。但是自從有了對(duì)象展開(kāi)運(yùn)算符(現(xiàn)處于 ECMASCript 提案 stage-3 階段),我們可以極大地簡(jiǎn)化寫法:
import store from '../store';
class Index {
computed = {
localComputed() {
/* ... */
},
// 使用對(duì)象展開(kāi)運(yùn)算符將此對(duì)象混入到外部對(duì)象中
...store.mapState({
// ...
}),
};
}
export default new Index();
使用 CML 內(nèi)置的 store 并不意味著你需要將所有的狀態(tài)放入store。雖然將所有的狀態(tài)放到 CML 內(nèi)置的 store 會(huì)使?fàn)顟B(tài)變化更顯式和易調(diào)試,但也會(huì)使代碼變得冗長(zhǎng)和不直觀。如果有些狀態(tài)嚴(yán)格屬于單個(gè)組件,最好還是作為組件的局部狀態(tài)。你應(yīng)該根據(jù)你的應(yīng)用開(kāi)發(fā)需要進(jìn)行權(quán)衡和確定。
有時(shí)候我們需要從 store 中的 state 中派生出一些狀態(tài),例如對(duì)列表進(jìn)行過(guò)濾并計(jì)數(shù):
computed: {
doneTodosCount () {
return store.state.todos.filter(todo => todo.done).length
}
}
如果有多個(gè)組件需要用到此屬性,我們要么復(fù)制這個(gè)函數(shù),或者抽取到一個(gè)共享函數(shù)然后在多處導(dǎo)入它——無(wú)論哪種方式都不是很理想。
chameleon 內(nèi)置 store 允許我們?cè)?store 中定義“getter”(可以認(rèn)為是 store 的計(jì)算屬性)。就像計(jì)算屬性一樣,getter 的返回值會(huì)根據(jù)它的依賴被緩存起來(lái),且只有當(dāng)它的依賴值發(fā)生了改變才會(huì)被重新計(jì)算。
Getter 接受 state 作為其第一個(gè)參數(shù):
import createStore from 'chameleon-store';
const store = createStore({
state: {
todos: [
{ id: 1, text: '...', done: true },
{ id: 2, text: '...', done: false },
],
},
getters: {
doneTodos: (state) => {
return state.todos.filter((todo) => todo.done);
},
},
});
export default store;
Getter 會(huì)暴露為 store.getters 對(duì)象:
store.getters.doneTodos; // -> [{ id: 1, text: '...', done: true }]
Getter 也可以接受其他 getter 作為第二個(gè)參數(shù), rootState 作為第三個(gè)參數(shù):
getters: {
// ...
doneTodosCount: (state, getters, rootState) => {
return getters.doneTodos.length;
};
}
store.getters.doneTodosCount; // -> 1
我們可以很容易地在任何組件中使用它:
computed: {
doneTodosCount () {
return store.getters.doneTodosCount
}
}
你也可以通過(guò)讓 getter 返回一個(gè)函數(shù),來(lái)實(shí)現(xiàn)給 getter 傳參。在你對(duì) store 里的數(shù)組進(jìn)行查詢時(shí)非常有用。
getters: {
// ...
getTodoById: (state) => (id) => {
return state.todos.find((todo) => todo.id === id);
};
}
store.getters.getTodoById(2); // -> { id: 2, text: '...', done: false }
mapGetters 輔助函數(shù)僅僅是將 store 中的 getter 映射到局部計(jì)算屬性:
import store from '../store';
class Index {
// ...
computed = {
// 使用對(duì)象展開(kāi)運(yùn)算符將 getter 混入 computed 對(duì)象中
...store.mapGetters([
'doneTodosCount',
'anotherGetter',
// ...
]),
};
}
export default new Index();
如果你想將一個(gè) getter 屬性另取一個(gè)名字,使用對(duì)象形式:
store.mapGetters({
// 映射 `this.doneCount` 為 `store.getters.doneTodosCount`
doneCount: 'doneTodosCount',
});
更改 CML 內(nèi)置 store 的 store 中的狀態(tài)的唯一方法是提交 mutation。chameleon 內(nèi)置 store 中的 mutation 非常類似于事件:每個(gè) mutation 都有一個(gè)字符串的 事件類型 (type) 和 一個(gè) 回調(diào)函數(shù) (handler)。這個(gè)回調(diào)函數(shù)就是我們實(shí)際進(jìn)行狀態(tài)更改的地方,并且它會(huì)接受 state 作為第一個(gè)參數(shù):
import createStore from 'chameleon-store';
const store = createStore({
state: {
count: 1,
},
mutations: {
increment(state) {
// 變更狀態(tài)
state.count++;
},
},
});
export default store;
你不能直接調(diào)用一個(gè) mutation handler。這個(gè)選項(xiàng)更像是事件注冊(cè):“當(dāng)觸發(fā)一個(gè)類型為 increment 的 mutation 時(shí),調(diào)用此函數(shù)?!币獑拘岩粋€(gè) mutation handler,你需要以相應(yīng)的 type 調(diào)用 store.commit 方法:
store.commit('increment');
你可以向 store.commit 傳入額外的參數(shù),即 mutation 的 載荷(payload):
// ...
mutations: {
increment (state, n) {
state.count += n
}
}
store.commit('increment', 10);
在大多數(shù)情況下,載荷應(yīng)該是一個(gè)對(duì)象,這樣可以包含多個(gè)字段并且記錄的 mutation 會(huì)更易讀:
// ...
mutations: {
increment (state, payload) {
state.count += payload.amount
}
}
store.commit('increment', {
amount: 10,
});
既然 CML 內(nèi)置 store 中的狀態(tài)是響應(yīng)式的,那么當(dāng)我們變更狀態(tài)時(shí),監(jiān)視狀態(tài)的 CML 組件也會(huì)自動(dòng)更新。這也意味著 CML 內(nèi)置 store 中的 mutation 也需要與使用 CML 一樣遵守一些注意事項(xiàng):
使用常量替代 mutation 事件類型在各種 Flux 實(shí)現(xiàn)中是很常見(jiàn)的模式。這樣可以使 linter 之類的工具發(fā)揮作用,同時(shí)把這些常量放在單獨(dú)的文件中可以讓你的代碼合作者對(duì)整個(gè) app 包含的 mutation 一目了然:
// mutation-types.js
export const SOME_MUTATION = 'SOME_MUTATION';
// store.js
import createStore from 'chameleon-store'
import { SOME_MUTATION } from './mutation-types'
const store = createStore({
state: { ... },
mutations: {
// 我們可以使用 ES2015 風(fēng)格的計(jì)算屬性命名功能來(lái)使用一個(gè)常量作為函數(shù)名
[SOME_MUTATION] (state) {
// mutate state
}
}
})
export default store
用不用常量取決于你——在需要多人協(xié)作的大型項(xiàng)目中,這會(huì)很有幫助。但如果你不喜歡,你完全可以不這樣做。
一條重要的原則就是要記住 mutation 必須是同步函數(shù)。為什么?請(qǐng)參考下面的例子:
mutations: {
someMutation (state) {
api.callAsyncMethod(() => {
state.count++
})
}
}
現(xiàn)在想象,我們正在 debug 一個(gè) app 并且觀察 devtool 中的 mutation 日志。每一條 mutation 被記錄,devtools 都需要捕捉到前一狀態(tài)和后一狀態(tài)的快照。然而,在上面的例子中 mutation 中的異步函數(shù)中的回調(diào)讓這不可能完成:因?yàn)楫?dāng) mutation 觸發(fā)的時(shí)候,回調(diào)函數(shù)還沒(méi)有被調(diào)用,devtools 不知道什么時(shí)候回調(diào)函數(shù)實(shí)際上被調(diào)用——實(shí)質(zhì)上任何在回調(diào)函數(shù)中進(jìn)行的狀態(tài)的改變都是不可追蹤的。
你可以在組件中使用 store.commit('xxx') 提交 mutation,或者使用 mapMutations 輔助函數(shù)將組件中的 methods 映射為 store.commit 調(diào)用。
import store from '../store';
createComponent({
// ...
methods: {
...store.mapMutations([
'increment', // 將 `this.increment()` 映射為 `store.commit('increment')`
// `mapMutations` 也支持載荷:
'incrementBy', // 將 `this.incrementBy(amount)` 映射為 `store.commit('incrementBy', amount)`
]),
...store.mapMutations({
add: 'increment', // 將 `this.add()` 映射為 `store.commit('increment')`
}),
},
});
在 mutation 中混合異步調(diào)用會(huì)導(dǎo)致你的程序很難調(diào)試。例如,當(dāng)你調(diào)用了兩個(gè)包含異步回調(diào)的 mutation 來(lái)改變狀態(tài),你怎么知道什么時(shí)候回調(diào)和哪個(gè)先回調(diào)呢?這就是為什么我們要區(qū)分這兩個(gè)概念。在 CML 內(nèi)置 store 中,mutation 都是同步事務(wù):
store.commit('increment');
// 任何由 "increment" 導(dǎo)致的狀態(tài)變更都應(yīng)該在此刻完成。
Action 類似于 mutation,不同在于:
讓我們來(lái)注冊(cè)一個(gè)簡(jiǎn)單的 action:
import createStore from 'chameleon-store';
const store = createStore({
state: {
count: 0,
},
mutations: {
increment(state) {
state.count++;
},
},
actions: {
increment(context) {
context.commit('increment');
},
increment2({ rootState, state, getters, dispatch, commit }) {},
},
});
export default store;
Action 函數(shù)接受一個(gè) context 對(duì)象,因此你可以調(diào)用 context.commit 提交一個(gè) mutation,或者通過(guò) context.rootState、context.state 和 context.getters 來(lái)獲取全局 state、局部 state 和 全局 getters。
實(shí)踐中,我們會(huì)經(jīng)常用到 ES2015 的參數(shù)解構(gòu)來(lái)簡(jiǎn)化代碼(特別是我們需要調(diào)用 commit 很多次的時(shí)候):
actions: {
increment ({ commit }) {
commit('increment')
}
}
Action 通過(guò) store.dispatch 方法觸發(fā):
store.dispatch('increment');
乍一眼看上去感覺(jué)多此一舉,我們直接分發(fā) mutation 豈不更方便?實(shí)際上并非如此,還記得 mutation 必須同步執(zhí)行這個(gè)限制么?Action 就不受約束!我們可以在 action 內(nèi)部執(zhí)行異步操作:
actions: {
incrementAsync ({ commit }) {
setTimeout(() => {
commit('increment')
}, 1000)
}
}
Actions 支持同樣的載荷方式進(jìn)行分發(fā):
// 以載荷形式分發(fā)
store.dispatch('incrementAsync', {
amount: 10,
});
來(lái)看一個(gè)更加實(shí)際的購(gòu)物車示例,涉及到調(diào)用異步 API 和分發(fā)多重 mutation:
actions: {
checkout ({ commit, state }, products) {
// 把當(dāng)前購(gòu)物車的物品備份起來(lái)
const savedCartItems = [...state.cart.added]
// 發(fā)出結(jié)賬請(qǐng)求,然后樂(lè)觀地清空購(gòu)物車
commit(types.CHECKOUT_REQUEST)
// 購(gòu)物 API 接受一個(gè)成功回調(diào)和一個(gè)失敗回調(diào)
shop.buyProducts(
products,
// 成功操作
() => commit(types.CHECKOUT_SUCCESS),
// 失敗操作
() => commit(types.CHECKOUT_FAILURE, savedCartItems)
)
}
}
注意我們正在進(jìn)行一系列的異步操作,并且通過(guò)提交 mutation 來(lái)記錄 action 產(chǎn)生的副作用(即狀態(tài)變更)。
你在組件中使用 store.dispatch('xxx') 分發(fā) action,或者使用 mapActions 輔助函數(shù)將組件的 methods 映射為 store.dispatch 調(diào)用:
import store from '../store';
class Index {
methods = {
...store.mapActions([
'increment', // 將 `this.increment()` 映射為 `store.dispatch('increment')`
// `mapActions` 也支持載荷:
'incrementBy', // 將 `this.incrementBy(amount)` 映射為 `store.dispatch('incrementBy', amount)`
]),
...store.mapActions({
add: 'increment', // 將 `this.add()` 映射為 `store.dispatch('increment')`
}),
};
}
export default new Index();
Action 通常是異步的,那么如何知道 action 什么時(shí)候結(jié)束呢?更重要的是,我們?nèi)绾尾拍芙M合多個(gè) action,以處理更加復(fù)雜的異步流程?
首先,你需要明白 store.dispatch 可以處理被觸發(fā)的 action 的處理函數(shù)返回的 Promise,并且 store.dispatch 仍舊返回 Promise:
actions: {
actionA ({ commit }) {
return new Promise((resolve, reject) => {
setTimeout(() => {
commit('someMutation')
resolve()
}, 1000)
})
}
}
現(xiàn)在你可以:
store.dispatch('actionA').then(() => {
// ...
});
在另外一個(gè) action 中也可以:
actions: {
// ...
actionB ({ dispatch, commit }) {
return dispatch('actionA').then(() => {
commit('someOtherMutation')
})
}
}
最后,如果我們利用async / await,我們可以如下組合 action:
// 假設(shè) getData() 和 getOtherData() 返回的是 Promise
actions: {
async actionA ({ commit }) {
commit('gotData', await getData())
},
async actionB ({ dispatch, commit }) {
await dispatch('actionA') // 等待 actionA 完成
commit('gotOtherData', await getOtherData())
}
}
一個(gè) store.dispatch 在不同模塊中可以觸發(fā)多個(gè) action 函數(shù)。在這種情況下,只有當(dāng)所有觸發(fā)函數(shù)完成后,返回的 Promise 才會(huì)執(zhí)行。
當(dāng)應(yīng)用變得非常復(fù)雜時(shí),store 對(duì)象就有可能變得相當(dāng)臃腫。
為了解決以上問(wèn)題,chameleon 內(nèi)置 store 允許我們將 store 分割成模塊(module)。每個(gè)模塊擁有自己的 state、mutation、action、getter、甚至是嵌套子模塊——從上至下進(jìn)行同樣方式的分割:
import createStore from 'chameleon-store'
const moduleA = {
state: { ... },
mutations: { ... },
actions: { ... },
getters: { ... }
}
const moduleB = {
state: { ... },
mutations: { ... },
actions: { ... }
}
const store = createStore({
modules: {
a: moduleA,
b: moduleB
}
})
store.state.a // -> moduleA 的狀態(tài)
store.state.b // -> moduleB 的狀態(tài)
對(duì)于模塊內(nèi)部的 mutation 和 getter,接收的第一個(gè)參數(shù)是模塊的局部狀態(tài)對(duì)象。
const moduleA = {
state: { count: 0 },
mutations: {
increment(state) {
// 這里的 `state` 對(duì)象是模塊的局部狀態(tài)
state.count++;
},
},
getters: {
doubleCount(state) {
return state.count * 2;
},
},
};
同樣,對(duì)于模塊內(nèi)部的 action,局部狀態(tài)通過(guò) context.state 暴露出來(lái),根節(jié)點(diǎn)狀態(tài)則為 context.rootState:
const moduleA = {
// ...
actions: {
incrementIfOddOnRootSum({ state, commit, rootState }) {
if ((state.count + rootState.count) % 2 === 1) {
commit('increment');
}
},
},
};
對(duì)于模塊內(nèi)部的 getter,根節(jié)點(diǎn)狀態(tài)會(huì)作為第三個(gè)參數(shù)暴露出來(lái):
const moduleA = {
// ...
getters: {
sumWithRootCount(state, getters, rootState) {
return state.count + rootState.count;
},
},
};
在 store 創(chuàng)建之后,你可以使用 store.registerModule 方法注冊(cè)模塊:
// 注冊(cè)模塊 `myModule`
store.registerModule('myModule', {
// ...
});
之后就可以通過(guò) store.state.myModule 訪問(wèn)模塊的狀態(tài)。
ChameleonStore.createStore(options: Object): Object
Store 構(gòu)造器。
通過(guò) chameleon-store 創(chuàng)建的 Store 實(shí)例,有以下方法:
Store.commit(type: string, payload?: any)
提交 mutation。
Store.dispatch(type: string, payload?: any)
分發(fā) action。
Store.mapState(map:Array<string>|Object<string>): Object
為組件創(chuàng)建計(jì)算屬性以返回 store 中的狀態(tài)。
Store.mapGetters(map:Array<string>|Object<string>): Object
為組件創(chuàng)建計(jì)算屬性以返回 getter 的返回值。
Store.mapMutations(map:Array<string>|Object<string>): Object
創(chuàng)建組件方法提交 mutation。
Store.mapActions(map:Array<string>|Object<string>): Object
創(chuàng)建組件方法分發(fā) action。
Store.registerModule(path: String, module: Module)
注冊(cè)一個(gè)動(dòng)態(tài)模塊。
更多建議: