jQuery | removeData() 与示例

jQuery.removeData() 方法用于从被选元素中移除已存储的数据。该方法将指定键名的数据从元素中删除。

语法

$(selector).removeData(name)

• name：可选参数。要移除数据的键名。如果为空，则将所有数据移除。

返回值

该方法没有返回值。

示例

以下示例演示如何使用 jQuery.removeData() 方法：

// HTML 代码
<div id="myDiv" data-name="John" data-age="25">This is a div.</div>

// jQuery 代码
$(document).ready(function(){
  // 获取先前设置的数据
  var name = $("#myDiv").data("name");
  var age = $("#myDiv").data("age");
  console.log(name + ", " + age); // John, 25

  // 移除指定键名的数据
  $("#myDiv").removeData("age");

  // 再次获取数据
  var name2 = $("#myDiv").data("name");
  var age2 = $("#myDiv").data("age");
  console.log(name2 + ", " + age2); // John, undefined

  // 移除所有数据
  $("#myDiv").removeData();
  var name3 = $("#myDiv").data("name");
  var age3 = $("#myDiv").data("age");
  console.log(name3 + ", " + age3); // undefined, undefined
});

在上面的代码中，先设置了 data-name 和 data-age 两个自定义数据属性，并使用 $("#myDiv").data() 方法分别获取了对应的数据。然后使用 $("#myDiv").removeData() 方法移除了 data-age 数据，并再次获取所有数据，得到的结果表明 data-age 已被成功移除。最后使用 $("#myDiv").removeData() 方法移除了所有数据。

注意事项

• name 参数可以是任何字符串，但建议使用字母、数字和下划线。
• 如果被选元素不存在与所指定的数据键相对应的数据，则此方法不起任何作用。