DIV CSS 佈局教程網

jQuery 全選與取消全選的通用寫法
編輯:JavaScript綜合知識     

全選功能看起來簡單,但 jQuery 版本差異讓 attr 與 prop 之爭折騰了很多人。這裡提供一個真正跨版本的通用寫法。

用 name 屬性分組

關鍵設計:同一組核取方塊共用相同的 name,全選按鈕藉此判斷要作用在哪一組。不要用 id(id 必須唯一,無法分組),也不要用其他自訂屬性。

取得某組的選中值

function getCheckboxValues(name) {
  return $(":checkbox[name=" + name + "]:checked")
           .map(function () { return $(this).val(); })
           .get()
           .join(",");
}

map() 回傳 jQuery 物件,串 .get() 轉成真陣列,才能用 join()。

全選/全不選

function chkAll(obj) {
  var name = $(obj).attr("name");

  // 方法一:jQuery 1.6 以上
  // $(":checkbox[name=" + name.substring(0, 1) + "]")
  //   .prop("checked", $(obj).prop("checked"));

  // 方法二:jQuery 1.6 以下
  // $(":checkbox[name=" + name.substring(0, 1) + "]")
  //   .attr("checked", $(obj).attr("checked"));

  // 方法三:通用寫法(任何版本)
  $(":checkbox[name=" + name.substring(0, 1) + "]").each(function () {
    this.checked = obj.checked;
  });
}

原版註解說「也許你覺得我寫得太複雜,但 jQuery 版本眾多,可以學點東西總是好的」——這個體貼是對的。attr 與 prop 在 1.6 前後的行為完全不同,用原生 DOM 的 this.checked 則任何版本都能動。

取得所有組的選中值

function getValues() {
  var aV = getCheckboxValues("a");
  var bV = getCheckboxValues("b");
  var cV = getCheckboxValues("c");

  var result = "a組選中值: " + (aV == "" ? "未選中任何值" : aV) + "\n" +
               "b組選中值: " + (bV == "" ? "未選中任何值" : bV) + "\n" +
               "c組選中值: " + (cV == "" ? "未選中任何值" : cV);
  alert(result);
}

完整 HTML

<script type="text/javascript"
        src="https://ajax.googleapis.com/ajax/libs/jquery/1.8.2/jquery.min.js"></script>

<div>
  <span>第1組(a):<input type="checkbox" name="aAll" onclick="chkAll(this)" />全選/全不選</span>
  <input type="checkbox" name="a" value="a1" checked />a1
  <input type="checkbox" name="a" value="a2" checked />a2
  <input type="checkbox" name="a" value="a3" />a3
  <input type="checkbox" name="a" value="a4" />a4<br />

  <span>第2組(b):<input type="checkbox" name="bAll" onclick="chkAll(this)" />全選/全不選</span>
  <input type="checkbox" name="b" value="b1" />b1
  <input type="checkbox" name="b" value="b2" checked />b2
  <input type="checkbox" name="b" value="b3" checked />b3
  <input type="checkbox" name="b" value="b4" />b4<br />

  <span>第3組(c):<input type="checkbox" name="cAll" onclick="chkAll(this)" />全選/全不選</span>
  <input type="checkbox" name="c" value="c1" />c1
  <input type="checkbox" name="c" value="c2" />c2
  <input type="checkbox" name="c" value="c3" checked />c3
  <input type="checkbox" name="c" value="c4" checked />c4<br /><br />

  <input type="button" value="查詢每組選中的值" onclick="getValues()" />
</div>

name.substring(0, 1) 的假設

原版用 name.substring(0, 1) 從 "aAll" 取出 "a"。這依賴「全選按鈕的 name 必定是組名加 All」的命名慣例,很脆弱。若改成用 data 屬性明確指定,會可靠得多:

<input type="checkbox" data-group="a" class="check-all" />

$(".check-all").on("change", function () {
  var group = $(this).data("group");
  $(":checkbox[name=" + group + "]").prop("checked", this.checked);
});

三個實務提醒

用 this.checked 而非 attr。jQuery 3 已移除 attr("checked", ...) 設定狀態的能力,通用寫法反而是唯一選項。

屬性值含特殊字元要加引號。$(":checkbox[name=" + name + "]") 在 name 含 -、[ 等字元時會解析錯誤,寫成 '[name="' + name + '"]' 比較安全。

全選狀態應該雙向同步。使用者逐個勾完所有項目時,全選框該自動被勾上;取消任一項時,全選框該取消。這需要額外監聽 change 事件比對數量:

$(".item-check").on("change", function () {
  var total = $(".item-check").length;
  var checked = $(".item-check:checked").length;
  $(".check-all").prop("checked", total === checked)
                 .prop("indeterminate", checked > 0 && checked < total);
});

indeterminate 屬性能讓全選框顯示「部分選取」的橫線狀態,是使用者很熟悉但常被忽略的細節。

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