日常專案中,只要是列表型的文章或資料頁,幾乎都會用到 checkbox 的全選功能。以前寫過好幾次,但都沒有整理過。正好前幾天有朋友遇到這個問題,索性花點時間用原生 JavaScript 與 jQuery 各寫一個版本。考慮到使用時的靈活性,這裡不做額外封裝,需要的讀者自行調整相關參數即可。

本文實作涵蓋三個功能:
1. 全選/全不選一體化:清單中 checkbox 的狀態與表頭全選框保持同步;
2. 自動回寫:清單中的 checkbox 全部勾選時,表頭全選框也自動勾上,反之亦然;
3. 點擊整行也能勾選,並與上述兩項功能聯動。
此外,本文重點在全選邏輯,滑鼠移入移出的背景變色僅為簡易示範,更完善的版本可參考:https://www.jb51.net/article/24125.htm
原生 JavaScript 版本
HTML 結構:
<form id="js" name="js" action="#"> <h5>原生JS樣例</h5> <dl> <dt><label for="js_chk_0"><input type="checkbox" id="js_chk_0" name="chk_can" value="" />全選/全不選</label></dt> <dd><span>2010-12-12</span><input type="checkbox" name="jsitems" value="" />原生JS實現的全選/全不選,點行也可選中或取消</dd> <dd><span>2010-12-12</span><input type="checkbox" name="jsitems" value="" />原生JS實現的全選/全不選,點行也可選中或取消</dd> <dd><span>2010-12-12</span><input type="checkbox" name="jsitems" value="" />原生JS實現的全選/全不選,點行也可選中或取消</dd> <dd><span>2010-12-12</span><input type="checkbox" name="jsitems" value="" />原生JS實現的全選/全不選,點行也可選中或取消</dd> <dd><span>2010-12-12</span><input type="checkbox" name="jsitems" value="" />原生JS實現的全選/全不選,點行也可選中或取消</dd> <dt><label for="js_chk_1"><input type="checkbox" id="js_chk_1" name="chk_can" value="" />全選/全不選</label></dt> </dl> </form>
JavaScript 邏輯:
// 原生 JS 實現全選全不選類
window.onload = function iCheckAll(){
var js_chk = document.forms['js'].chk_can;
var jsitems = document.forms['js'].jsitems;
var jsrows = document.getElementById('js').getElementsByTagName('dd');
// 依選中個數與總數比較,決定全選框的狀態
var chk_canle = function(){
var checkedLen = 0;
// 計算清單中處於選中狀態的 checkbox 個數
for (var m = 0; m < jsitems.length; m++) {
if (jsitems[m].checked) {
checkedLen += 1;
}
}
// 判斷選中個數與實際個數是否相同
for (var m = 0; m < js_chk.length; m++) {
js_chk[m].checked = (jsitems.length == checkedLen);
}
};
// 全選與全不選一體實現
for (var i = 0; i < js_chk.length; i++) {
js_chk[i].onclick = function(){
// 清單中 checkbox 與全選框統一狀態
for (var m = 0; m < jsitems.length; m++) {
jsitems[m].checked = this.checked;
}
// 全選框之間也統一狀態
for (var m = 0; m < js_chk.length; m++) {
js_chk[m].checked = this.checked;
}
};
}
// 清單中 checkbox 的點擊
for (var i = 0; i < jsitems.length; i++) {
jsitems[i].onclick = function(e){
// 阻止冒泡,避免行點擊事件中直接選擇 checkbox 失效
e && e.stopPropagation ? e.stopPropagation() : window.event.cancelBubble = true;
chk_canle();
};
}
// 點選整行
for (var i = 0; i < jsrows.length; i++) {
jsrows[i].onclick = function(){
// 點行時,把行內 checkbox 狀態取反
var cb = this.getElementsByTagName('input')[0];
cb.checked = !cb.checked;
chk_canle();
};
// 滑入滑出效果參考 https://mrthink.net/javascript-tagnames-highlight/
jsrows[i].onmouseover = function(){ this.className = 'hover'; };
jsrows[i].onmouseout = function(){ this.className = ''; };
}
}
jQuery 版本
HTML 結構:
<form id="jq" name="jq" action="#"> <h5>jQuery樣例</h5> <dl> <dt><label for="jq_chk_0"><input type="checkbox" id="jq_chk_0" name="chk_can" value="" />全選/全不選</label></dt> <dd><span>2010-12-12</span><input type="checkbox" name="jqitems" value="" />基於jQuery的全選/全不選,點行也可選中或取消</dd> <dd><span>2010-12-12</span><input type="checkbox" name="jqitems" value="" />基於jQuery的全選/全不選,點行也可選中或取消</dd> <dd><span>2010-12-12</span><input type="checkbox" name="jqitems" value="" />基於jQuery的全選/全不選,點行也可選中或取消</dd> <dd><span>2010-12-12</span><input type="checkbox" name="jqitems" value="" />基於jQuery的全選/全不選,點行也可選中或取消</dd> <dd><span>2010-12-12</span><input type="checkbox" name="jqitems" value="" />基於jQuery的全選/全不選,點行也可選中或取消</dd> <dt><label for="jq_chk_1"><input type="checkbox" id="jq_chk_1" name="chk_can" value="" />全選/全不選</label></dt> </dl> </form>
jQuery 邏輯:
// jQ 實現全選全不選
$(function(){
var _jq_chk = $('#jq>dl>dt>label>:checkbox');
var _jqitems = $(':checkbox[name=jqitems]');
var _rows = $('#jq>dl>dd');
// 全選與全不選一體實現
_jq_chk.click(function(){
// 清單中 checkbox 和全選框統一狀態
_jqitems.add(_jq_chk).attr('checked', this.checked);
});
// checkbox 的點擊事件
_jqitems.click(function(e){
// 阻止冒泡,避免行點擊事件中直接選擇 checkbox 失效
e.stopPropagation();
// 判斷選中個數與實際個數是否相同
_jq_chk.attr('checked',
_jqitems.size() == _jqitems.filter(':checked').size());
});
// 點選整行時選中行內的 checkbox
_rows.bind({
mouseenter: function(){ $(this).addClass('hover'); },
mouseleave: function(){ $(this).removeClass('hover'); },
click: function(){
// 行內點擊時,checkbox 狀態取反
$(this).find(':checkbox')
.attr('checked', !$(this).find(':checkbox').get(0).checked);
// 判斷選中個數與實際個數是否相同
_jq_chk.attr('checked',
_jqitems.size() == _jqitems.filter(':checked').size());
}
});
});
兩者的差異與選擇
這份程式碼比一般版本長一些,主要因為多了「點擊整行即可勾選」的功能。功能越多,程式碼自然越長,可依需求自行增刪。
相信很多做 Web 的人都遇過這個困惑:到底該用 jQuery 還是原生 JS?其實兩者最終都跑在同一套瀏覽器 API 上,jQuery 只是幫你抹平了差異並簡化了語法。就這段邏輯而言,jQuery 版本靠 add() 與 filter(':checked') 確實短了不少;但原生版本沒有外部依賴、載入更快,也更能看清底層發生了什麼事。
兩個實務提醒
第一,.attr('checked', ...) 在 jQuery 1.6 之後語意有所變動,控制勾選狀態應改用 .prop('checked', ...);.size() 也已改為 .length。若使用較新版本的 jQuery,這兩處需要調整。
第二,原生版本中 js_chk[i].onclick = function(){ ... this.checked ... } 內的 this 指向被點擊的那個全選框,這正是多個全選框能各自獨立運作的關鍵;理解這點,就不容易在改寫時把 this 用錯。