jQuery中的attr()與prop()設定屬性、獲取屬性的區別

※ 定義和用法

attr() / prop() 方法設定或返回被選元素的屬性和值。

當該方法用於返回屬性值時，則返回第一個匹配元素的值。

當該方法用於設定屬性值時，則為匹配元素集合設定一個或多個屬性/值對。

$("img").attr({width:"150",height:"100"});

注意：prop() 方法應該用於檢索屬性值，例如 DOM 屬性（如 selectedIndex, tagName, nodeName, nodeType, ownerDocument, defaultChecked, 和 defaultSelected）。

提示：如需檢索 HTML 屬性，請使用 attr()方法代替。

※語法

返回屬性的值：

設定屬性和值：

使用函式設定屬性和值：

設定多個屬性和值：

<div id="n1">
    <p id="n2" class="demo test" data-key="UUID" data_value="1235456465">CodePlayer</p>
    <input id="n3" name="order_id" type="checkbox" value="1">
    <input id="n4" name="order_id" type="checkbox" checked="checked" value="2">
    <img id="n5" alt="CodePlayer" src="/image/blank.gif" >
    <img id="n6" alt="站點logo" title="專注於程式設計開發技術分享" src="http://static/image/site-url.png" >
</div>
<ul id="n7">
     <li id="n8" uid="21">item1</li>
     <li id="n9" uid="23">item2</li>
     <li id="n10" uid="35">item3</li>
 </ul>

var $n2 = $("#n2");
// prop()操作針對的是元素(Element物件)的屬性，而不是元素節點(HTML文件)的屬性
document.writeln( $n2.prop("data-key") ); // undefined
document.writeln( $n2.attr("data-key") ); // UUID
document.writeln( $n2.prop("data_value") ); // undefined
document.writeln( $n2.attr("data_value") ); // 1235456465
// 獲取n2的myAttr屬性的值，沒有該屬性，返回undefined
document.writeln( $n2.attr("myAttr") ); //undefined

//設定n5(img元素)的src屬性值
$("#n5").attr("src", "http://localhost/static/image/site-name.png");

//只返回第一個匹配元素的uid屬性的值
document.writeln( $("li").attr("uid") ); // 21

// 以物件形式同時設定所有img元素的多個屬性值
$("img").attr( { height: 180, width: 180, "class": "img-box" } );
document.writeln( $("#n5").attr("height") ); // 180
// 設定所有img元素的title屬性值：
// 1.如果該元素已經有了title屬性，則不作改變
// 2.如果該元素之前沒有title屬性，則設定title屬性等於它的alt屬性
$("img").attr("title", function(index, attrValue){
    // 這裡的this表示當前DOM元素
    return attrValue== undefined ? this.alt : attrValue;    
});

document.writeln( $n2.prop("id") ); // n2
document.writeln( $n2.prop("tagName") ); // P
document.writeln( $n2.prop("className") ); // demo test
document.writeln( $n2.prop("innerHTML") ); // CodePlayer
document.writeln( typeof $n2.prop("getAttribute") ); // function

// prop()設定的屬性也是針對元素(Element物件)，因此也可以通過元素本身直接訪問
$n2.prop("prop_a", "CodePlayer");
document.writeln( $n2[0].prop_a ); // CodePlayer
var n2 = document.getElementById("n2");
document.writeln( n2.prop_a ); // CodePlayer

// 以物件形式同時設定多個屬性，屬性值可以是物件、陣列等任意型別
$n2.prop( { 
    prop_b: "baike",
    prop_c: 18,
    site: { name: "CodePlayer", url: "http://www.365mini.com/" }
} );
document.writeln( $n2[0].prop_c ); // 18
document.writeln( $n2[0].site.url ); // http://www.365mini.com/

// 反選所有的複選框(沒選中的改為選中，選中的改為取消選中)
$("input:checkbox").prop("checked", function(index, oldValue){
    return !oldValue;
});

但不得不說的是，這兩個函式的用處卻並不相同。下面我們來詳細介紹這兩個函式之間的區別。

1、操作物件不同

很明顯，attr和prop分別是單詞attribute和property的縮寫，並且它們均表示"屬性"的意思。

不過，在jQuery中，attribute和property卻是兩個不同的概念。attribute表示HTML文件節點的屬性，property表示JS物件的屬性。

<!-- 這裡的id、class、data_id均是該元素文件節點的attribute -->
<div id="message" class="test" data_id="123"></div>

<script type="text/javascript">
// 這裡的name、age、url均是obj的property
var obj = { name: "CodePlayer", age: 18, url: "http://www.365mini.com/" };
</script>

<!-- attr()函式針對的是該文件節點的attribute -->
<div id="message" class="test" data_id="123"></div>

<script type="text/javascript">

// prop()函式針對的是該DOM元素(msg)自身的property
var msg = document.getElementById("message");
var $msg = $(msg);

</script>

<div id="message" class="test" data_id="123"></div>
<script type="text/javascript">
var msg = document.getElementById("message");
var $msg = $(msg);

/* *** attr()依賴的是Element物件的element.getAttribute( attribute ) 和 element.setAttribute( attribute, value ) *** */

// 相當於 msg.setAttribute("data_id", 145);
$msg.attr("data_id", 145);

// 相當於 msg.getAttribute("data_id");
var dataId = $msg.attr("data_id"); // 145

/* *** prop()依賴的是JS原生的 element[property] 和 element[property] = value; *** */

// 相當於 msg["pid"] = "pid值";
$msg.prop("pid", "pid值");

// 相當於 msg["pid"];
var testProp = $msg.prop("pid"); // pid值
</script>

當然，jQuery對這些操作方式進行了封裝，使我們操作起來更加方便(比如以物件形式同時設定多個屬性)，並且實現了跨瀏覽器相容。

此外，雖然prop()針對的是DOM元素的property，而不是元素節點的attribute。

不過DOM元素某些屬性的更改也會影響到元素節點上對應的屬性。例如，property的id對應attribute的id，property的className對應attribute的class。

<div id="message" class="test" data_id="123"></div>
<script type="text/javascript">
var msg = document.getElementById("message");
var $msg = $(msg);

document.writeln( $msg.attr("class") ); // test
$msg.prop("className", "newTest");
// 修改className(property)導致class(attitude)也隨之更改
document.writeln( $msg.attr("class") ); // newTest
</script>

2、應用版本不同

attr()是jQuery 1.0版本就有的函式，prop()是jQuery 1.6版本新增的函式。毫無疑問，在1.6之前，你只能使用attr()函式；1.6及以後版本，你可以根據實際需要選擇對應的函式。

3、用於設定的屬性值型別不同

由於attr()函式操作的是文件節點的屬性，因此設定的屬性值只能是字串型別，如果不是字串型別，也會呼叫其

prop()函式操作的是JS物件的屬性，因此設定的屬性值可以為包括陣列和物件在內的任意型別。

4、其他細節問題

在jQuery 1.6之前，只有attr()函式可用，該函式不僅承擔了attribute的設定和獲取工作，還同時承擔了property的設定和獲取工作。例如：在jQuery 1.6之前，attr()也可以設定或獲取tagName、className、nodeName、nodeType等DOM元素的property。

直到jQuery 1.6新增prop()函式，並用來承擔property的設定或獲取工作之後，attr()才只用來負責attribute的設定和獲取工作。

注意（重點）：

此外，對於表單元素的checked、selected、disabled等屬性，在jQuery 1.6之前，attr()獲取這些屬性的返回值為Boolean型別：如果被選中(或禁用)就返回true，否則返回false。

但是從1.6開始，使用attr()獲取這些屬性的返回值為String型別，如果被選中(或禁用)就返回checked、selected或disabled，否則(即元素節點沒有該屬性)返回undefined。並且，在某些版本中，這些屬性值表示文件載入時的初始狀態值，即使之後更改了這些元素的選中(或禁用)狀態，對應的屬性值也不會發生改變。

因為jQuery認為：attribute的checked、selected、disabled就是表示該屬性初始狀態的值，property的checked、selected、disabled才表示該屬性實時狀態的值(值為true或false)。

四、總結：

因此，在jQuery 1.6及以後版本中，請使用prop()函式來設定或獲取checked、selected、disabled等屬性。對於其它能夠用prop()實現的操作，也儘量使用prop()函式。

attr() 獲取的是初始狀態的值，即使取消了選中，也不會改變。

prop() 獲取的值已經發生變化，是實時狀態的值。

<input id="uid" type="checkbox" checked="checked" value="1">

<script type="text/javascript">
// 當前jQuery版本為1.11.1
var uid = document.getElementById("uid");
var $uid = $(uid);

document.writeln( $uid.attr("checked") ); // checked
document.writeln( $uid.prop("checked") ); // true

// 取消複選框uid的選中(將其設為false即可)
// 相當於 uid.checked = false;
$uid.prop("checked", false);

// attr()獲取的是初始狀態的值，即使取消了選中，也不會改變
document.writeln( $uid.attr("checked") ); // checked
// prop()獲取的值已經發生變化
document.writeln( $uid.prop("checked") ); // false
</script>

補充：

另外，常用的Attribute，例如id、class、title等，已經被作為Property附加到DOM物件上，可以和Property一樣取值和賦值。但是自定義的Attribute，就不會有這樣的特殊優待，例如：

<div id="div1" class="divClass" title="divTitle" title1="divTitle1">100</div>

這個div裡面的“title1”就不會變成Property。

補充：刪除移除相關屬性：

JQuery的removeProp()與removeAttr()移除屬性的區別