← jQuery jQuery.Deferred() 方法 jQuery wrap() 方法 →

jQuery .data() 方法

jQuery $.data() 函数用于在指定的元素上存取数据，返回设置值

语法

用法一

$.data( element, key, value )

通过data()函数存取的数据都是临时数据，一旦页面刷新，之前存放的数据都将被移除
undefined 是一个没有被识别数据值

调用 jQuery.data( el, "name", undefined ) 将返回对应的 "name" 数据，等价于 jQuery.data(el, "name" )

我们可以在一个元素上设置不同的值，并获取这些值：

jQuery.data(document.body, 'foo', 52);
jQuery.data(document.body, 'bar', 'test');

用法二

$.data( element, key )

我们可以在一个元素上设置不同的值，并获取这些值

alert(jQuery.data( document.body, 'foo' ));
alert(jQuery.data( document.body ));

参数

参数	描述
element	Element类型要存储数据的DOM对象
key	可选。String类型指定的键名字符串
value	可选。 Object类型需要存储的任意类型的数据

说明

这是一个底层方法，.data() 方法更方便使用
通过 data() 函数存取的数据都是临时数据，一旦页面刷新，之前存放的数据都将被移除
该方法目前并不提供在XML文档上跨平台设置，Internet Explorer 不允许在XML文档中通过自定义属性附加数据

范例

在 div 元素上先存储再获取数据

<div>
    存储的值为
    <span></span>
    和
    <span></span>
</div>
<script>
$(function () { 
    var div = $( "div" )[ 0 ];
    jQuery.data( div, "test", {
        first: 16,
        last: "pizza!"
    });
    $( "span:first" ).text( jQuery.data( div, "test" ).first );
    $( "span:last" ).text( jQuery.data( div, "test" ).last );
})
</script>

运行范例 »

简单教程

jQuery .data() 方法

语法

参数

说明

范例

更多范例

jQuery 参考手册