jQuery中attr()prop()data()用法及区别

Posted 2020-07-05 Nick

.attr()，此方法从jq1.0开始一直存在，官方文档写的作用是读/写DOM的attribute值，其实1.6之前有时候是attribute，有时候又是property。
.prop()，此方法jq1.6引入，读/写DOM的property。
.data()，此方法在jq1.2.3引入，作用是把任意的值读取/存储到DOM元素对应的jq对象上。

从性能上对比，.prop() > .data() > .attr()，不同浏览器不同版本.data()和.attr()的性能关系有差异，不过.prop()总是最优的。

一、先说attr()与prop()：
在jQuery中，attr()函数和prop()函数都用于设置或获取指定的属性，它们的参数和用法也几乎完全相同，但这两个函数的用处却有着不同。

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>

在jQuery中，
prop()的设计目标用于设置或获取指定DOM元素(指的是JS对象，Element类型)上的属性(property);
attr()的设计目标是用于设置或获取指定DOM元素所对应的文档节点上的属性(attribute)。

<!-- 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);
//$msg.prop("***")与msg.***中的***基本是相同的，比如$msg.prop("tagName")/msg.tagName
</script>

在jQuery的底层实现中，attr()和prop的功能都是通过js原生的Element对象(如上述代码中的msg)实现的。
attr()主要依赖的是Element对象的getAttribute()和setAttribute()两个方法。prop()主要依赖的则是js中原生的对象属性获取和设置方式。

<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.pid = "pid值"
$msg.prop("pid", "pid值");
// 相当于 msg["pid"] 或 msg.pid 
var testProp = $msg.prop("pid"); // pid值
</script>

 此外，虽然prop()针对的是DOM元素的property，而不是元素节点的attribute。不过DOM元素某些属性的更改也会影响到元素节点上对应的属性。例如，property的id对应attribute的id，property的className对应attribute的class。
如：$msg.prop("className","newTest")与$msg.attr("class","newTest")相同

2.应用版本不同
如最开始所说，attr()是jQuery1.0版本就有的函数，prop()是jQuery1.6版本新增的函数。
即，在1.6之前只能使用attr()，在1.6及其以后版本，可以根据实际需要选择对应的函数。

3.用于设置的属性值类型不同
用于attr()操作的是文档节点的属性，因此设置的属性值只能是字符串类型，如果不是字符串类型，也会调用其toString()方法将其转换为字符串类型。prop()操作的是js对象的属性，设置的属性值可以为包括数组和对象在内的任意类型。

4.其他问题
在jQuery1.6之前，只有attr()可用，该函数同时承担了attribute的设置/获取工作和property的设置和获取工作。例如：在jQuery 1.6之前，attr()也可以设置或获取tagName、className、nodeName、nodeType等DOM元素的property。直到jQuery 1.6新增prop()函数，并用来承担property的设置或获取工作之后，attr()才只用来负责attribute的设置和获取工作。此外，对用表单元素的"checked"、"selected"、"disabled"等属性，在jq1.6之前，attr()获取这些属性返回的值为Boolean类型，如果被选中(或禁用)就返回true，否则返回false。

但从1.6开始，使用attr()获取这些属性的返回值为String类型，如果被选中(或禁用)就返回"checked"、"selected"、"disabeld",否则(即元素节点没有该属性)返回undefined。并且在某些版本中，这些属性值表示文档加载时的初始状态值，即使之后更改了这些元素的选中(或禁用)状态，对应的属性值也不会发生改变。因为jQuery认为：attribute的"checked"、"selected"、"disabled"就是表示该属性初始状态的值，property的checked、selected、disabeld才表示该属性实时状态的值(值为true或false)。
因此，从1.6开始，请使用prop()来设置或获取checked、selected、disabled等属性。对于其它能够prop()实现的操作，也尽量使用prop()。比如，selectedIndex, tagName, nodeName, nodeType, ownerDocument应该使用.prop()方法获取/设置值。

值得注意的是对于a标签的href属性，prop()与attr()取得的值不同，prop是绝对地址，attr()取的就是href中的值，如：

<a href="#" id="adom" data-name="doma"></a>
<script>
console.log(adom.prop("href");//file:///C:/Users/Administrator/Desktop/testapp/1.html#
console.log(adom.prop("href"));//#
</script>

注:在IE9之前版本中，如果property没有在DOM元素被移除之前删除，使用.prop()方法设置DOM元素property（简单类型除外：number、string、boolean）的值会导致内存泄露。为了安全的设置DOM对象的值，避免内存泄露，可以使用.data()方法。

二、data()
在html5中DOM标签可以添加一些data-xxx的属性，可以把data()看作是存取data-xxx这样的DOM附加信息的方法。data()存取的内容可以是字符串、数组和对象。从jQuery1.4.3起，html5的data-xxx属性会自动被添加到jq的data对象里，比如：

<div data-role="page" data-last-value="43" data-hidden="true" data-options=‘{"name":"noahlu"}‘></div>

下面的等式都成立：

$("div").data("role") === "page";
$("div").data("lastValue") === 43;
$("div").data("hidden") === true;
$("div").data("options").name === "noahlu";

虽然data()用来存数据挺方便的，它也是有过不堪回首的过去，如：

<button id="foo" data-key="1.4000">Click me</button>
<script>
typeof $(‘#foo‘).data(‘key‘);
</script>

jQuery 1.8之前的版本输出’number’，1.8版本之后输出为’string’。
1.8版之前，data会把值转换成基本类型，其实我们这里想要的是’1.4000′并不是1.4。

data()设置值后，attr()不能获取设置后的值,比如：

<a href="javascript:;" id="adom" data-name="doma"></a>
<script>
var adom = $("#adom");
adom.data("name","name1");
console.log("attr:"+adom.attr("data-name"));//doma
console.log("data:"+adom.data("name"));//name1
</script>