返回值:jQuery data([key],[value])
概述
在元素上存放或讀取資料,返回jQuery對象。
當參數只有一個key的時候,為讀取該jQuery對像對應DOM中儲存的key對應的值,值得注意的是,如果瀏覽器支援HTML5,同樣可以讀取該DOM中使用 data-[key] = [value] 所儲存的值。參見最後一個示例。
當參數為兩個時,為像該jQuery對像對應的DOM中儲存key-value鍵值對的資料。
如果jQuery集合指向多個元素,那將在所有元素上設定對應資料。 這個函式不用建立一個新的expando,就能在一個元素上存放任何格式的資料,而不僅僅是字串。
V1.4.3 新增用法, data(obj) 可傳入key-value形式的資料。
參數
key String V1.23
儲存的資料名.
key,value String,Any V1.2.3
key :儲存的資料名
value :將要儲存的任意資料
obj object V1.4.3
一個用於設定資料的鍵/值對
data() V1.4.3
示例
描述:
在一個div上存取資料
HTML 程式碼:
<div></div>
jQuery 程式碼:
$("div").data("blah"); // undefined
$("div").data("blah", "hello"); // blah設定為hello
$("div").data("blah"); // hello
$("div").data("blah", 86); // 設定為86
$("div").data("blah"); // 86
$("div").removeData("blah"); //移除blah
$("div").data("blah"); // undefined
描述:
在一個div上存取名/值對資料
HTML 程式碼:
<div></div>
jQuery 程式碼:
$("div").data("test", { first: 16, last: "pizza!" });
$("div").data("test").first //16;
$("div").data("test").last //pizza!;
描述:
在HTML5規範中div中讀取預存的data-[key]值
HTML 程式碼:
<div data-test="this is test" ></div>
jQuery 程式碼:
$("div").data("test"); //this is test!;