一個網上流傳很廣的 checkbox 全選示例,換到 Firefox 下卻跑不通,這背後其實是 jQuery 版本演進帶來的 API 分工變化。
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="https://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
<title>test</title>
<script type="text/javascript" src="jquery-1.9.1.js"></script>
<script type="text/javascript">
$(function () {
// 全選
$("#btnCheckAll").bind("click", function () {
$("[name = chkItem]:checkbox").attr("checked", true);
});
// 全不選
$("#btnCheckNone").bind("click", function () {
$("[name = chkItem]:checkbox").attr("checked", false);
});
// 反選
$("#btnCheckReverse").bind("click", function () {
$("[name = chkItem]:checkbox").each(function () {
$(this).attr("checked", !$(this).attr("checked"));
});
});
// 提交:收集選中項
$("#btnSubmit").bind("click", function () {
var result = new Array();
$("[name = chkItem]:checkbox").each(function () {
if ($(this).is(":checked")) {
result.push($(this).attr("value"));
}
});
alert(result.join(","));
});
});
</script>
</head>
<body>
<div>
<input name="chkItem" type="checkbox" value="今日話題" />今日話題
<input name="chkItem" type="checkbox" value="視覺焦點" />視覺焦點
<input name="chkItem" type="checkbox" value="財經" />財經
<input name="chkItem" type="checkbox" value="汽車" />汽車
<input name="chkItem" type="checkbox" value="科技" />科技
<input name="chkItem" type="checkbox" value="房產" />房產
<input name="chkItem" type="checkbox" value="旅游" />旅游
</div>
<div>
<input id="btnCheckAll" type="button" value="全選" />
<input id="btnCheckNone" type="button" value="全不選" />
<input id="btnCheckReverse" type="button" value="反選" />
<input id="btnSubmit" type="button" value="提交" />
</div>
</body>
</html>
在 Firefox 下:第一次點全選可以,接著點全不選也可以;但再點全選、全不選、反選就全部失去反應。換其他瀏覽器卻正常,看上去像兼容性問題,查閱資料後確認是 API 使用不當。
把 attr 換成 prop 即可,各瀏覽器表現一致:
$("#btnCheckAll").click(function () {
$("[name=chkItem]:checkbox").prop("checked", true);
});
$("#btnCheckNone").click(function () {
$("[name=chkItem]:checkbox").prop("checked", false);
});
$("#btnCheckReverse").click(function () {
$("[name=chkItem]:checkbox").each(function () {
$(this).prop("checked", !$(this).prop("checked"));
});
});
效果圖:

jQuery 1.6 之前,attr() 在讀取 checked、selected、disabled 時會返回 DOM 屬性值,行為與今天的 prop() 一致。1.6 為了讓 attr() 語義更純粹(只操作 HTML 屬性),改變了這一行為,結果導致大量依賴舊行為的代碼出錯。社區反彈強烈,1.6.1 又做了妥協,但官方明確建議新代碼一律使用 prop。
第一,反選的判斷依據。示例用 !$(this).attr("checked") 取反,attr 返回字符串,取反結果不可靠;應改為 !$(this).prop("checked"),或者直接用 .is(":checked")。
第二,取值用 attr 讀 value 是可以的。value 屬於「有默認值也有當前值」的屬性,讀取時用 attr("value") 得到的是 HTML 中寫死的初始值,用 prop("value") 或 .val() 得到的是當前值。若用戶可能在 JS 中改過 value,應使用 .val()。
另外,bind() 已不再推薦,改用 on() 是更面向未來的寫法。