將原生 <input type="checkbox"> 轉換為可完全 CSS 控制的 <span> 結構,支持:
data-on/data-off 屬性)
(function($) {
$.fn.tzCheckbox = function(options) {
// 默認配置
var settings = $.extend({
labels: ['ON', 'OFF'] // [開啟文本, 關閉文本]
}, options);
return this.each(function() {
var $original = $(this); // 原生 checkbox
var labels = settings.labels;
// 優先讀取 HTML5 data 屬性
if ($original.data('on')) {
labels[0] = $original.data('on');
labels[1] = $original.data('off') || labels[1];
}
// 構建新結構
var $checkBox = $('', {
className: 'tzCheckBox ' + (this.checked ? 'checked' : ''),
html: '' + labels[this.checked ? 0 : 1] + '' +
'' // 裝飾性部件(如滑塊背景)
});
// 插入並隱藏原生
$checkBox.insertAfter($original.hide());
// 點擊新元素觸發狀態切換
$checkBox.click(function() {
$checkBox.toggleClass('checked');
var isChecked = $checkBox.hasClass('checked');
// 同步原生 checkbox(關鍵:表單提交時自動攜帶正確值)
$original.prop('checked', isChecked).trigger('change');
// 更新顯示文本
$checkBox.find('.tzCBContent').text(labels[isChecked ? 0 : 1]);
});
// 監聽原生 change 事件(如 JS 代碼觸發 $original.prop('checked', true) 時同步 UI)
$original.on('change', function() {
$checkBox.click(); // 觸發同樣邏輯
});
});
};
})(jQuery);
.tzCheckBox {
display: inline-block;
position: relative;
width: 60px;
height: 28px;
border-radius: 14px;
background: #ddd;
cursor: pointer;
transition: background 0.2s;
user-select: none;
}
.tzCheckBox.checked { background: #007bff; }
.tzCheckBox .tzCBContent {
position: absolute;
top: 50%; left: 50%;
transform: translate(-50%, -50%);
font-size: 12px; font-weight: bold; color: #fff;
white-space: nowrap;
}
.tzCheckBox .tzCBPart {
position: absolute;
top: 2px; left: 2px;
width: 24px; height: 24px;
border-radius: 50%;
background: #fff;
box-shadow: 0 1px 3px rgba(0,0,0,0.3);
transition: left 0.2s;
}
.tzCheckBox.checked .tzCBPart { left: 34px; } /* 60-24-2=34 */
/* 隱藏原生但保留可訪問性 */
.tzCheckBox + input[type="checkbox"] { position: absolute; opacity: 0; pointer-events: none; }
<!-- 基礎用法 -->
<input type="checkbox" id="agree" class="custom-check">
<label for="agree">同意條款</label>
<!-- 自定義文本 -->
<input type="checkbox" id="notify" data-on="啟用" data-off="關閉">
<script>
$(function() {
$('.custom-check').tzCheckbox(); // 使用默認 ON/OFF
$('#notify').tzCheckbox(); // 自動讀取 data-on/off
});
</script>
$.fn.tzRadio = function(options) {
var settings = $.extend({ label: '' }, options);
return this.each(function() {
var $original = $(this);
var name = $original.attr('name'); // 必須有 name 分組
var $radio = $('', {
className: 'tzRadio' + ($original.is(':checked') ? ' checked' : ''),
html: '' + (settings.label || '') + ''
}).insertAfter($original.hide());
$radio.click(function() {
// 同組只能選一:先取消同組其他
$('input[name="' + name + '"]').not($original).each(function() {
$(this).prop('checked', false).next('.tzRadio').removeClass('checked');
});
$original.prop('checked', true).trigger('change');
$radio.addClass('checked');
});
$original.on('change', function() {
$radio.click();
});
});
};
為符合 WCAG,需補充:
role="checkbox" + aria-checked="true/false"tabindex="0" 支持鍵盤聚焦keydown 監聽 Space/Enter 切換// 在插件 click 綁定前添加
$checkBox.attr({ 'role': 'checkbox', 'aria-checked': this.checked, 'tabindex': 0 })
.on('keydown', function(e) {
if (e.key === ' ' || e.key === 'Enter') {
e.preventDefault();
$(this).click();
}
});
// 狀態更新時同步 aria
$checkBox.attr('aria-checked', isChecked);
本插件通過隱藏原生控件 + 構建語義化替代結構 + 雙向同步狀態實現樣式完全可控。核心設計點:
checkbox 確保表單提交正常data-* 屬性實現零 JS 配置同理可擴展實現 Radio、Switch、Select 等表單控件美化,構建統一設計語言的表單組件庫。