?
本文檔使用 PHP中文網(wǎng)手冊(cè) 發(fā)布
在元素上存放或讀取數(shù)據(jù),返回jQuery對(duì)象。
當(dāng)參數(shù)只有一個(gè)key的時(shí)候,為讀取該jQuery對(duì)象對(duì)應(yīng)DOM中存儲(chǔ)的key對(duì)應(yīng)的值,值得注意的是,如果瀏覽器支持HTML5,同樣可以讀取該DOM中使用 data-[key] = [value] 所存儲(chǔ)的值。參見最后一個(gè)示例。
當(dāng)參數(shù)為兩個(gè)時(shí),為像該jQuery對(duì)象對(duì)應(yīng)的DOM中存儲(chǔ)key-value鍵值對(duì)的數(shù)據(jù)。
如果jQuery集合指向多個(gè)元素,那將在所有元素上設(shè)置對(duì)應(yīng)數(shù)據(jù)。 這個(gè)函數(shù)不用建立一個(gè)新的expando,就能在一個(gè)元素上存放任何格式的數(shù)據(jù),而不僅僅是字符串。
V1.4.3 新增用法, data(obj) 可傳入key-value形式的數(shù)據(jù)。
存儲(chǔ)的數(shù)據(jù)名.
key:存儲(chǔ)的數(shù)據(jù)名
value:將要存儲(chǔ)的任意數(shù)據(jù)
一個(gè)用于設(shè)置數(shù)據(jù)的鍵/值對(duì)
在一個(gè)div上存取數(shù)據(jù)
<div></div>
$("div").data("blah"); // undefined $("div").data("blah", "hello"); // blah設(shè)置為hello $("div").data("blah"); // hello $("div").data("blah", 86); // 設(shè)置為86 $("div").data("blah"); // 86 $("div").removeData("blah"); //移除blah $("div").data("blah"); // undefined
在一個(gè)div上存取名/值對(duì)數(shù)據(jù)
<div></div>
$("div").data("test", { first: 16, last: "pizza!" }); $("div").data("test").first //16; $("div").data("test").last //pizza!;
在HTML5規(guī)范中div中讀取預(yù)存的data-[key]值
<div data-test="this is test" ></div>
$("div").data("test"); //this is test!;