如何在原生微信小程序中實現數據雙向綁定

官網：https://qiu8310.github.io/minapp/

做者：Mora

在原生小程序開發中，數據流是單向的，沒法雙向綁定，可是要實現雙向綁定的功能仍是蠻簡單的！

下文要講的是小程序框架 minapp 中實現雙向綁定的原理，在 minapp 中，你只須要在 wxml 模板中給組件的屬性名後加上 .sync 就能夠實現雙向綁定。下面爲了解釋其原理，過程可能會說的稍微複雜些，但其實 minapp 框架已經處理了那些繁雜的細節！

首先，要使數據雙向綁定，應該避免過多的數據源。
在數據從上到下天然流動的狀況下，若是每一個組件中都維護它們本身的數據，而又要保持它們數據值的一致，這雖然能夠作到，但實現過程並不會簡單。
可是也不必說爲了有一個統一的數據源就使用 mobx 或 redux 來全局管理數據，這就有點殺雞用牛刀的感受了。
因爲雙向綁定只存在於父子組件之間，而數據又是從父到子傳遞的，因此能夠優先使用父組件中的數據爲數據源，
子組件每次更新數據並不更新它本身內部的數據，而是經過事件機制觸發父組件更新它的數據，而父組件更新數據後又會將更新的數據天然地傳給子組件，
由此達到數據的雙向流動！

並非全部數據都須要雙向綁定，也並非全部數據都是對外的，子組件還能夠有它本身的一個內部數據。因此這就涉及到咱們要說的第二個問題：區分哪些數據須要雙向綁定，哪些數據又須要子組件本身維護。

用過 vue 的應該都知道，在 vue 中要實現雙向綁定，須要在模板中作特殊處理。好比要將父組件的 parentAttr 雙向綁定到子組件的 childAttr 上，須要在父組件的模板中這樣寫：

<child childAttr.sync="parentAttr" />

可是小程序並無這樣的簡單的語法，小程序的 wxml 語言的屬性名中甚至都不容許出現 " . " 這樣的字符。回到咱們的問題上來，子組件須要知道哪些屬性須要雙向綁定，哪些屬性須要本身維護，
給模板加個字段（syncAttrMap）專門來告訴子組件須要雙向綁定的數據集合不就好了麼。如，能夠將上面的示例寫成微信小程序支持的寫法：

<child childAttr="{{parentAttr}}" syncAttrMap="childAttr=parentAttr" />

<!--
  若是同時存在多個雙向綁定和不須要雙向綁定的屬性時，能夠寫成下面這樣：
  p1, p2 分別雙向綁定到子組件的 c1, c2，而 p3 單向綁定到 c3 上
-->

<child c1="{{p1}}" c2="{{p2}}" c3="{{p3}}" syncAttrMap="c1=p1&c2=p2" />

接着，就須要處理子組件數據更新的問題了，在子組件中有兩部分數據，一部分是內部數據，另外一部分是父組件中的數據，
子組件能夠經過讀取屬性 syncAttrMap 來獲得哪些數據是內部的數據，哪些數據是父組件的數據，而且能夠知道對應
的父組件中的數據的鍵名是什麼。因爲原生的組件方法 setData 不會管你是內部數據，仍是父組件中的數據，只要
你調用它去更新數據，它只會更新內部的數據。因此須要另外實現一個新的方法，來自動判斷數據源，若是是內部數據，
則直接調用 setData ；若是是雙向綁定中的父組件數據，則能夠觸發一個事件去通知父組件去更新對應的值。

因此根據上面的描述，父組件須要有個監聽函數，子組件須要有個智能的 setData 函數。不防將父組件的監聽函數
命名爲 onSyncAttrUpdate，將子組件的智能 setData 函數命名爲 setDataSmart，則能夠有以下代碼：

// 父組件
Component({
  methods: {
    onSyncAttrUpdate(e) {
      this.setData(e.detail) // 子組件傳來的須要更新的數據
    }
  }
})

<!-- 父組件的模板 -->
<child childAttr="{{parentAttr}}" syncAttrMap="childAttr=parentAttr" bind:syncAttrUpdate="onSyncAttrUpdate" />

// 子組件
Component({
  properties: {
    childAttr: String,
    syncAttrMap: String
  },
  methods: {
    // 子組件更新數據時，只要調用此方法便可，而不是 `setData`
    setDataSmart(data) {
      // splitDataBySyncAttrMap 函數的實現過程就不說了，只是將對象拆分，你們應該都能實現
      let {parentData, innerData} = splitDataBySyncAttrMap(data, this.data.syncAttrMap)

      // 內部數據使用 setData 更新
      if (Object.keys(innerData).length) {
        this.setData(innerData) // setData 中還支持 callback 的回調，爲了簡化代碼，這裏不討論
      }

      // 雙向綁定的父組件數據觸發事件讓父組件本身去更新
      if (Object.keys(parentData).length) {
        this.triggerEvent('syncAttrUpdate', parentData)
      }
    }
  }
})

到此，一個簡單的雙向綁定功能就完成了。可是因爲子組件也有可能包含其它組件，也就是說子組件也能夠是父組件，而父組件一樣也
能夠是子組件。因此上面的 onSyncAttrUpdate setDataSmart 函數須要在每一個組件中都實現，因此不防
定義一個公共對象 BaseComponent 來實現上面的全部功能，如：

// BaseComponent
const BaseComponent = {
  properties: {
    syncAttrMap: String
  },
  methods: {
    setDataSmart() {
      // ...
    },
    onSyncAttrUpdate() {
      // ...
    }
  }
}

而後將 BaseComponent minin 到每一個組件的對象上去就能夠了；另外小程序中還有一個特殊的組件：Page，雖然 Page 和 Component 結構是兩樣的，
但它也應該算是一個組件，不過它必定是父組件，不多是別的組件的子組件，因此還須要將 onSyncAttrUpdate 方法寫了全部的 Page 定義中。
全部這些就是 minapp 的雙向綁定的基本原理了。

等等，最後還有一件事：wxml 模板，不能讓用戶每次寫雙向綁定的時候都要寫那麼複雜語句吧？固然不用，minapp 在編譯時，會將模板作個簡單的轉化：

<child childAttr.sync="parentAttr" />

<!-- 因爲屬性名 syncAttrMap 是固定的，因此徹底能夠經過編譯手段，將上面的模板轉成下面這個模板 -->

<child childAttr="{{parentAttr}}" syncAttrMap="childAttr=parentAttr" />

謝謝，文章到此結束，歡迎關注 minapp：從新定義微信小程序的開發