DIV CSS 佈局教程網

用 jQuery 替換原生 checkbox 樣式的插件實現
編輯:JavaScript綜合知識     

原生 checkbox 的樣式在各瀏覽器下差異明顯,也很難與設計稿對齊。常見解法是「藏起原生控件,自繪一個替身,兩者狀態保持同步」。本文以一個 jQuery 插件為例說明完整做法。

效果預覽

呈現出來的是一個帶 ON / OFF 文案的方形開關,點擊可切換,樣式完全由 CSS 掌控。

插件代碼

(function ($) {
  $.fn.tzCheckbox = function (options) {
    // 默認的開 / 關文案
    options = $.extend({ labels: ['ON', 'OFF'] }, options);

    return this.each(function () {
      var originalCheckBox = $(this),
          labels = [];

      // 優先讀取 HTML5 data 屬性上的自定義文案
      if (originalCheckBox.data('on')) {
        labels[0] = originalCheckBox.data('on');
        labels[1] = originalCheckBox.data('off');
      } else {
        labels = options.labels;
      }

      // 構造替身節點
      var checkBox = $('<span>', {
        className: 'tzCheckBox ' + (this.checked ? 'checked' : ''),
        html: '<span class="tzCBContent">' + labels[this.checked ? 0 : 1] +
              '</span><span class="tzCBPart"></span>'
      });

      // 插入替身並隱藏原生控件
      checkBox.insertAfter(originalCheckBox.hide());

      // 點擊替身時同步原生控件
      checkBox.click(function () {
        checkBox.toggleClass('checked');
        var isChecked = checkBox.hasClass('checked');
        originalCheckBox.attr('checked', isChecked);
        checkBox.find('.tzCBContent').html(labels[isChecked ? 0 : 1]);
      });

      // 原生控件變化時反向同步替身
      originalCheckBox.bind('change', function () {
        checkBox.click();
      });
    });
  };
})(jQuery);

實現要點

  • 約定式插件接口:掛到 $.fn 上並返回 this.each(...),保證支持鏈式調用與多元素批量初始化。
  • 配置可覆蓋:用 $.extend 合併默認 labels,調用時傳 $('.cb').tzCheckbox({ labels: ['启用','停用'] }) 即可改文案。
  • HTML5 data 屬性優先:允許每個 checkbox 單獨指定文案,粒度比全局配置更細。
  • 雙向同步:點擊替身改原生控件,監聽原生 change 反向更新替身。這樣即使其他腳本以編程方式改了原生 checkbox,界面也不會與數據不一致。
  • 保留原生元素:只是 hide() 而非刪除,表單提交時仍會帶上原字段,後端無需改動。

實戰中值得加固的幾處

  1. 無障礙:替身是 span,鍵盤無法聚焦。建議給它加 tabindex="0" 與 role="checkbox",並監聽 keydown 的空格鍵;同時用 aria-checked 同步狀態。
  2. 用原生 change 事件而非 click:直接寫 originalCheckBox.trigger('change') 比調用替身自己的 click() 語義更準確,也能避免潛在的遞歸風險。
  3. attr('checked') 的歧義:在部分 jQuery 版本中,控制 checked 狀態更可靠的是 prop('checked', isChecked)。
  4. 樣式職責分離:tzCBPart 那個 span 通常用作滑動方塊,全部外觀交給 CSS,插件只負責切換 class,後續換皮不用改 JS。

這個插件不到 40 行,卻示範了「自繪控件」的完整套路:隱藏原生、渲染替身、雙向同步、配置外置。理解了它,自己寫任何自定義表單控件都有參照。

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