返回值:jQuerydata([key],[value])

jQuery data() 方法概述

在元素上存放或讀取數(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ǔ)的值。參見(jiàn)最后一個(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ù)。

參數(shù)

keyStringV1.23

存儲(chǔ)的數(shù)據(jù)名.

key,valueString,AnyV1.2.3

key:存儲(chǔ)的數(shù)據(jù)名

value:將要存儲(chǔ)的任意數(shù)據(jù)

objobjectV1.4.3

一個(gè)用于設(shè)置數(shù)據(jù)的鍵/值對(duì)

data()V1.4.3

示例

描述:

在一個(gè)div上存取數(shù)據(jù)

HTML 代碼:

<div></div>

jQuery 代碼:

$("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ù)

HTML 代碼:

<div></div>

jQuery 代碼:

$("div").data("test", { first: 16, last: "pizza!" });
$("div").data("test").first  //16;
$("div").data("test").last  //pizza!;

描述:

在HTML5規(guī)范中div中讀取預(yù)存的data-[key]值

HTML 代碼:

<div data-test="this is test" ></div>

jQuery 代碼:

$("div").data("test"); //this is test!;