DIV CSS 佈局教程網

jQuery 中 prop 與 attr 的分工:以 checkbox 全選反選為例
編輯:JQuery入門技巧     

一個網上流傳很廣的 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"));
    });
});

效果圖:

為什麼 1.6 是分水嶺

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() 是更面向未來的寫法。

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