data() 讓你能把任意資料掛在 DOM 元素上,之後再用名稱取回。相比把資料塞進自訂屬性,它有幾個明顯好處:可以存非字串型別(物件、陣列、函式),也不會污染 HTML 標籤。
$(selector).data(name, value)
name 是資料名稱,value 可以是任何型別的資料。
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>data() 方法</title>
<script type="text/javascript" src="jquery-1.8.3.js"></script>
<script type="text/javascript">
$(document).ready(function(){
$("#add").click(function(){
$("div").data("mydata","博客園歡迎您");
});
$("#show").click(function(){
$("div").text($("div").data("mydata"));
});
});
</script>
</head>
<body>
<div></div>
<button id="add">向元素添加數據</button>
<button id="show">顯示添加的數據</button>
</body>
</html>
先按「添加」,再按「顯示」,div 中就會出現我們存的那段文字。
$(selector).data(name)
只傳名稱時,data() 就變成取值的方法。上面範例中的 $("div").data("mydata") 就是這種用法。
$(selector).data(properties)
$("#add").click(function(){
$("div").data("mydata", {username:"daoliang"});
});
$("#show").click(function(){
alert($("div").data("mydata").username);
});
寫入時把物件放進去,讀取時先取出物件、再存取其中的屬性即可。這種寫法適合一次要掛多個相關欄位的場合。
$(selector).data(object)
var mytest = new Object();
mytest.first = "博客園歡迎您";
mytest.second = "JQuery專區";
$("#add").click(function(){
$("div").data(mytest);
});
$("#show").click(function(){
alert($("div").data("second"));
});
這時物件的每個屬性都會成為一筆獨立資料,名稱就是屬性名,因此可以直接用 data("second") 取值。
data() 存的資料只活在 jQuery 的內部快取中,並不會寫進 HTML 屬性,所以你在開發者工具裡看不到它,也不會隨 form 提交出去。若需要資料能被序列化或傳到後端,該用 data-* 屬性配合 .data() 的讀取能力(HTML5 data- 前綴的屬性會被自動對應),而不是依賴 this 附加的資料。