全選功能看起來簡單,但 jQuery 版本差異讓 attr 與 prop 之爭折騰了很多人。這裡提供一個真正跨版本的通用寫法。
關鍵設計:同一組核取方塊共用相同的 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);
}
<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) 從 "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 屬性能讓全選框顯示「部分選取」的橫線狀態,是使用者很熟悉但常被忽略的細節。