全選框有個常見的規格需求:勾上它,同群組的核取方塊全亮;取消它,全部熄燈;反過來,當群組裡每一項都被手動勾滿時,全選框也該自動被勾上。這個雙向連動用 checkgroup 插件幾行就能完成。
(function($){
$.fn.checkgroup = function(options){
// 合併設定
settings = $.extend({
groupSelector: null,
groupName: 'group_name',
enabledOnly: false
}, options || {});
var ctrl_box = this;
// 允許用 groupSelector 直接指定群組選擇器
var grp_slctr = (settings.groupSelector == null)
? 'input[name=' + settings.groupName + ']' : settings.groupSelector;
// 需要時只取「可用」的核取方塊
if(settings.enabledOnly){
grp_slctr += ':enabled';
}
// 全選框的點擊:把狀態同步給整群
ctrl_box.click(function(e){
chk_val = (e.target.checked);
$(grp_slctr).attr('checked', chk_val);
// 若頁面上還有其他全選框,一併同步
ctrl_box.attr('checked', chk_val);
});
// 群組內任一項被點擊:檢查是否需要回頭更新全選框
$(grp_slctr).click(function(){
if(!this.checked){
ctrl_box.attr('checked', false);
}else{
// 已勾選數量等於總數時,全選框自動亮起
if($(grp_slctr).size() == $(grp_slctr + ':checked').size()){
ctrl_box.attr('checked', 'checked');
}
}
});
// 保持 jQuery 的鏈式呼叫特性
return this;
};
})(jQuery);
群組定位有兩條路。如果呼叫時傳入 groupSelector,就直接用它(例如 '.groupclass');否則退回用 name 屬性組出 input[name=group]。前者彈性大,後者寫得省事。
enabledOnly 過濾無效項。表單裡常有 disabled 的核取方塊(例如依權限無法勾選的項目),加上 :enabled 後它們不會被全選掃到,也不會影響「是否已全選」的判斷。
雙向同步靠兩組 click。全選框的 click 往下推狀態;群組內各項的 click 則用「已勾數 == 總數」判斷是否要把全選框点亮。少了後者,使用者手動逐項勾滿時全選框仍會是空的。
<input type="checkbox" class="checkall">checkall<br>
<input class="groupclass" name="group" type="checkbox">chk1<br>
<input class="groupclass" name="group" type="checkbox">chk2<br>
<input class="groupclass" name="group" type="checkbox">chk3<br>
<input class="groupclass" name="group" type="checkbox">chk4<br>
寫法一,用 class 指定群組並排除 disabled 項:
$(function() {
$("#checkall").click(function() {
$('.checkall').checkgroup({
groupSelector: '.groupclass',
enabledOnly: true
});
});
});
寫法二,用 name 指定群組:
$(function() {
$("#checkall").click(function() {
$('#checkall').checkgroup({ groupName: 'group' });
});
});
插件用 attr('checked', ...) 設定勾選狀態,這是當時 jQuery 版本的標準做法。若你使用的是 jQuery 1.6 以後的版本,建議改用 prop('checked', ...),語意更準確,也能避免只改到屬性卻沒改到實際狀態的問題。另外記得把插件存成獨立 .js 檔再於頁面引入,方便多頁重複使用。