摘要：概要微信小程序的開發(fā)體驗(yàn)類似和，但是卻沒有提供全局狀態(tài)管理的機(jī)制，所以狀態(tài)的共享只能通過屬性傳遞的方式來實(shí)現(xiàn)。安裝將放入微信小程序項(xiàng)目的文件夾中，例如。

微信小程序的開發(fā)體驗(yàn)類似vue和react，但是卻沒有提供全局狀態(tài)管理的機(jī)制，所以狀態(tài)的共享只能通過屬性傳遞的方式來實(shí)現(xiàn)。這種做法在小規(guī)模的應(yīng)用中尚可以滿足開發(fā)效率，但是在復(fù)雜的應(yīng)用中組件的嵌套層次很深，屬性傳遞的路徑過長。

于是我就想利用小程序Page中的data對象來構(gòu)建一個全局store，這個store滿足一下幾點(diǎn)需求：

store可以被當(dāng)前頁面中任意一個組件訪問，并且這種訪問時(shí)直接的而不是通過屬性傳遞。

全局store對于組件是相應(yīng)式的，也就是說store的變化可以使組件發(fā)生重繪。

頁面和組件都可以修改store的狀態(tài)，并且這種修改不破壞原來的響應(yīng)式。

提供類似Vuex的開發(fā)體驗(yàn)，減小學(xué)習(xí)成本。

先附上源碼 github地址

我們先跳過原理來看使用方法。

將Store.js放入微信小程序項(xiàng)目的文件夾中，例如/lib/Store.js。

這里我們通過wxappStore.createPage來創(chuàng)建。對比一下Store.js和原來的創(chuàng)建方法的區(qū)別

// 原來的創(chuàng)建方法
Page({
  data: {
    message: ""
  },
  onLoad: function () {
    this.setData({
        message: "hello world"
    })
  }
})

// 增加全局狀態(tài)管理之后
import wxappStore from "../../lib/Store.js";

Page(wxappStore.createPage({
    // 第一個參數(shù)和原來傳入Page方法的option沒有區(qū)別。其中的data會作為全局共享對象來使用。
    data: {
        message: ""
    },
    onLoad: function () {
        // 通過dispatch方法，進(jìn)行一個異步操作。  
        this.store.dispatch({ 
            name: "testAction",
            payload: "hello world"
        });
        // 通過commit方法，修改全局狀態(tài)。
        this.store.commit({ 
            name: "testMutation",
            payload: "hello world"
        });
    }
}, 
// 第二個參數(shù)是一個對象，其中包含mutations和actions
{
    mutations: {
        testMutation: function({ setData, payload, data }) {
            setData({
                message: payload
            });
        }
    },
    actions: {
        testAction: function ({ commit, payload, data }) {
            setTimeout(() => {
                commit({
                    name: "testMutation",
                    payload: payload
                });
            });
        }
    }
}))

wxappStore.createPage方法有兩個參數(shù)。

第一個參數(shù)和原來傳入Page方法的option沒有區(qū)別。其中的data會作為全局共享對象來使用。

第二個參數(shù)是一個對象，其中包含mutations和actions

mutation和Vuex中的mutation類似，它通過同步的方式修改狀態(tài)。可以通過commit調(diào)用。

mutations在wxappStore.createPage的第二個參數(shù)中定義，它用于修改全局狀態(tài)。mutation通常同步的。mutation方法的參數(shù)是一個對象，包含三個屬性：

setData function： 用來修改全局狀態(tài)，在微信小程序中直接修改狀態(tài)不會觸發(fā)頁面重匯。

payload object：修改的狀態(tài)，可以是一個對象，也可以是String等基礎(chǔ)數(shù)據(jù)類型

data object：當(dāng)前狀態(tài)

mutations: {
    testMutation: function({ setData, payload, data }) {
        setData({
            message: payload
        });
    }
},

通過commit方法調(diào)用mutation，它的參數(shù)是一個對象，包含兩個屬性：

name String：mutation的名稱

payload Object：需要修改的狀態(tài)，和Vuex的payload類似。

this.store.commit({ 
    name: "testMutation",
    payload: "hello world"
});

action和Vuex中action概念類似，通常包含異步操作，在異步操作完成后進(jìn)行commit操作。

action方法的參數(shù)是一個參數(shù)，包含3個屬性：

commit function：執(zhí)行commit操作

payload Object：數(shù)據(jù)對象，和Vuex類型

data Object：當(dāng)前狀態(tài)

actions: {
    testAction: function ({ commit, payload, data }) {
        setTimeout(() => {
            commit({
                name: "testMutation",
                payload: payload
            });
        });
    }
}

通過dispatch方法調(diào)用action，它的參數(shù)是一個對象，包含兩個屬性：

name String：action的名稱

payload Object：需要修改的狀態(tài)，和Vuex的payload類似。

this.store.dispatch({ 
    name: "testAction",
    payload: "hello world"
});

在Component中我們需要完成兩項(xiàng)工作

第一將全局狀態(tài)綁定到當(dāng)前組件的data屬性上，并將組件的data屬性綁定到頁面元素上。

第二組件需要使用commit或者dispatch完成全局狀態(tài)的修改。

這里Store.j通過wxappStore.createComp來創(chuàng)建Component，它會通過代理的方式為Component實(shí)現(xiàn)全局狀態(tài)管理的功能。

import wxappStore from "../lib/Store.js";

Component(wxappStore.createComp({
  data: {
    localtimeData: ""
  },
  ready: function () {
    // 綁定全局狀態(tài)
    this.getGlobalData({ globalDataKey: "localtime", localDataKey: "localtimeData" });

    // 改變?nèi)譅顟B(tài)  
    this.store.commit({
        name: "testMutation",
        payload: (new Date()).toLocaleTimeString()
    })
  }
}))

讀取全局狀態(tài)：{{localtimeData}}

全局狀態(tài)綁定通過getGlobalData這個實(shí)例方法實(shí)現(xiàn)，這個方法并不在小程序的運(yùn)行環(huán)境中，它是Store.js執(zhí)行的過程中插入到Component實(shí)例中的。

getGlobalData 不能再created回調(diào)中調(diào)用，應(yīng)為component的實(shí)例方法setData不能再created中調(diào)用。

getGlobalData的參數(shù)是一個對象，包含兩個屬性：

globalDataKey String：這個屬性表示需要全局狀態(tài)的屬性名，這個全局狀態(tài)將于component的本地狀態(tài)綁定。

localDataKey String：這個屬性表示本地狀態(tài)的屬性名，這個本地狀態(tài)將于全局狀態(tài)綁定。

// 綁定全局狀態(tài)
this.getGlobalData({ globalDataKey: "localtime", localDataKey: "localtimeData" });

可以使用store.commit或者store.dispatch，store并不是小程序的運(yùn)行環(huán)境中內(nèi)置的，同樣是通過Store.js插入到每一個component實(shí)例中。它的使用方法和Page中的類似。

Store.js借用了Page對象的data屬性來完成全局狀態(tài)管理，所以data屬性的職責(zé)并不單一。data屬性兼具了頁面ViewModel的功能和全局狀態(tài)的功能。但是Page中的data屬性本來也具有全局意義，所以兩者的沖突并不大。

component中的data屬性職責(zé)并不單一。它兼具了本地屬性的功能和綁定全局狀態(tài)的功能。而且直接通過setData修改component中的data并不能觸發(fā)全局狀態(tài)的改變，因?yàn)閐ata的作用域僅限于當(dāng)前component，必須通過store.commit或者store.dispatch觸發(fā)發(fā)全局狀態(tài)的改變。

如果你發(fā)現(xiàn)其他問題，歡迎留言，我們共同進(jìn)步！