DIV CSS 佈局教程網

用 avalon 的 duplex 雙向綁定優雅實作 checkbox 全選
編輯:關於JavaScript     

用傳統寫法做「全選+反向同步」,通常要寫好幾層迴圈與 if 判斷。而 MVVM 框架的雙向綁定可以把這一切簡化到幾行程式碼——這正是本文想展示的對比。

需求

老實說很基本,但還是列清楚:勾選全選框,下方子選框全部勾上;取消全選框,子選框全部取消;子選框只要有一個沒勾,全選框自動取消;子選框全部勾上,全選框自動勾上。

效果預覽

HTML

<div id='wrap' ms-controller='duplex'>
  <p>
    <input type='checkbox' data-duplex-changed="select_all_cb"
           ms-duplex-checked='select_all'>全選
  </p>
  <ul>
    <li ms-repeat='list'>
      <input type='checkbox' ms-duplex-number="selected" ms-attr-value='el.id'>{{el.text}}
    </li>
  </ul>
  <p>選中項的 id:{{selected}}</p>
</div>

JavaScript

require('avalon', function(avalon) {
  var duplex = avalon.define('duplex', function(vm) {
    vm.selected = []; // 保存勾選項的 id,方便直接送後端
    vm.list = [
      {id:1,text:'aaa'}, {id:2,text:'bbb'}, {id:3,text:'ccc'},
      {id:4,text:'ddd'}, {id:5,text:'eee'}, {id:6,text:'fff'}
    ];

    vm.select_all_cb = function() {   // 全選框變更時的回呼
      var list = duplex.list, selected = duplex.selected;
      if (this.checked) {
        avalon.each(list, function(i, v) {
          selected.ensure(v['id']);   // 沒有就加入
        });
      } else {
        selected.clear();             // 清空
      }
    };
    vm.select_all = 0;
  });

  // 監聽已選陣列的長度變化,反向同步全選框
  duplex.selected.$watch('length', function(after) {
    var len = duplex.list.length;
    duplex.select_all = (after == len) ? 1 : 0;
  });

  avalon.scan();
});

四個關鍵點

一、data-duplex-changed 負責監聽 checkbox 的變化並觸發回呼,等同於 change 事件。

二、ms-duplex-number="selected" 是整套實作的核心。這個綁定讓 selected 陣列與所有子選框保持同步:陣列增減會更新畫面,使用者勾選也會更新陣列。兩個方向都不用自己寫。

三、型別必須對應。ms-duplex-* 的型別修飾詞要與 checkbox 的 value 型別一致,否則視圖不會同步。value 是數字就用 ms-duplex-number,是字串就用 ms-duplex-string。

四、別對型別想當然。作者分享了一個實際踩到的坑:後端傳來的明明是數字 id,卻遲遲無法同步視圖,最後改成 ms-duplex-string 才解決。也就是說 '7' 和 7 在綁定時是不等價的,資料來源不清楚時最好先印出來確認。

對比傳統寫法

如果不用 MVVM,同樣的需求至少要:為全選框綁 change、迴圈設定所有子選框;再為每個子選框綁 change、每次都要迴圈檢查是否全勾。資料狀態與畫面狀態各自為政,很容易不同步。

這正是雙向綁定的價值:你只需要維護一份「已選 id 陣列」這個單一真相來源,畫面會跟著它走,送表單也直接用這個陣列,不必再從 DOM 反查。

今天若使用 Vue,寫法幾乎一一對應:v-model="selected" 搭配 :value="item.id",再用 computed 處理全選狀態與 indeterminate,程式碼量差不多,觀念完全相通。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved