jQuery attr() prop() data()用法及区别
.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()函数都用于设置或获取指定的属性,它们的参数和用法也几乎完全相同,但这两个函数的用处却有着不同。
简单来说:
- 对于HTML元素本身就带有的固有属性(checked,selected等),在处理时,使用prop方法。
- 对于HTML元素我们自己自定义的DOM属性,在处理时,使用attr方法。
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>