data([key],[value]) | jQuery API 3.2 中文文档 | jQuery API 在线手册

jQuery API 3.2.1

推荐办理招商信用卡,新户首刷礼,五折享美食,需要的速度围观~click here
首页  >  核心  > data([key],[value]) 源码下载

返回值:jQuerydata([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!;