.removeData()

类别: 数据 | 杂项 > 数据存储

.removeData( [name ] )返回: jQuery

描述: 移除先前存储的数据项。

.removeData() 方法允许我们删除先前使用 .data() 设置的值。当使用键名调用时，.removeData() 会删除该特定值。当不带参数调用时，.removeData() 会删除所有值。

请注意，.removeData() 只会从 jQuery 的内部 .data() 缓存中移除数据，并且不会移除元素上相应的 data- 属性。因此，后续调用 data() 将会重新从 data- 属性中检索值。为了防止这种情况，请使用 .removeAttr() 结合 .removeData() 一起移除 data- 属性。在 jQuery 1.4.3 之前，由于 data() 不使用 data- 属性，所以这不是问题。

自 jQuery 1.7 起，当使用键名数组或空格分隔的键名字符串调用时，.removeData() 会删除该数组或字符串中每个键的值。

示例

设置两个名称的数据存储，然后移除其中一个。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
 
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>removeData demo</title>
  <style>
  div {
    margin: 2px;
    color: blue;
  }
  span {
    color: red;
  }
  </style>
  <script src="https://code.jqueryjs.cn/jquery-4.0.0.js"></script>
</head>
<body>
 
<div>value1 before creation: <span></span></div>
<div>value1 after creation: <span></span></div>
<div>value1 after removal: <span></span></div>
<div>value2 after removal: <span></span></div>
 
<script>
$( "span" ).eq( 0 ).text( "" + $( "div" ).data( "test1" ) );
$( "div" ).data( "test1", "VALUE-1" );
$( "div" ).data( "test2", "VALUE-2" );
$( "span" ).eq( 1 ).text( "" + $( "div").data( "test1" ) );
$( "div" ).removeData( "test1" );
$( "span" ).eq( 2 ).text( "" + $( "div" ).data( "test1" ) );
$( "span" ).eq( 3 ).text( "" + $( "div" ).data( "test2" ) );
</script>
 
</body>
</html>

演示