.removeData()| jqueryAPI 2.2 中文手册- AspRain.cn 致力于Web开发技术翻译整理

jQuery API 2.2.0

.removeData()

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

返回: jQuery

.removeData( [name ] )

描述:删除一条之前存储的数据段。

加入于: 1.2.3
.removeData( [name ] )
  • name
    类型:String
    一个字符串,它是要删除的数据段的名称。
加入于: 1.7
.removeData( [list ] )
  • list
    类型:Array or String
    一个数组或者空格分隔的字符串,它是要删除的数据段的名称。

.removeData()方法允许我们删除我们之前用.data()方法设置的数据值。如果带一个键名调用它,.removeData()会删除这个特定值。如果不带参数地调用它,.removeData()会删除所有值。

注意,.removeData()只会从jQuery内部的.data()缓存中删除数据,而元素上任何对应于元素属性data-的数据是不会被删除的。之后调用data(),将重新检索来自元素属性data-的值。要想防止这种情况,请用removeData()方法并用.removeAttr()方法,以删除元素属性data-。在jQuery 1.4.3中,比如说data(),不会使用data-元素属性,这也就不是一个可讨论的话题了。

自从jQuery 1.7,如果用一个键的数组或者一个空隔隔开的键的字符串来调用.removeData()方法,该方法会删除数组中或者字符串中的每个键的值。

示例

用两个名称存储一段数据,然后删除其中之一。

<!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.jquery.com/jquery-1.10.2.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>

演示结果

如果网页上不能运行示例,请点击http://www.asprain.cn/jQueryAPI/removedata.htm查看示例。

如果你觉得本文档对你有用,欢迎给翻译作者支付宝打赏,支持翻译作者源源不断翻译更多有用的技术文档。