DIV CSS 佈局教程網

自製 jQuery checkgroup 插件:連動的全選核取方塊
編輯:JQuery特效代碼     

全選框有個常見的規格需求:勾上它,同群組的核取方塊全亮;取消它,全部熄燈;反過來,當群組裡每一項都被手動勾滿時,全選框也該自動被勾上。這個雙向連動用 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 則用「已勾數 == 總數」判斷是否要把全選框点亮。少了後者,使用者手動逐項勾滿時全選框仍會是空的。

HTML 與呼叫方式

<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 檔再於頁面引入,方便多頁重複使用。

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