removeData() 的作用與 data() 正好相反,用來把掛在元素上的資料清掉。當資料只是一時的暫存狀態、任務結束後就該釋放時,用它收尾很合適。
$(selector).removeData(name)
參數 name 是可選的,用來指定要刪除的資料名稱。若完全省略參數,則會把該元素上所有已儲存的資料一次清空——這是個破壞性操作,呼叫前最好確認沒有其他地方還需要這些資料。
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>removeData() 方法</title>
<script type="text/javascript" src="jquery-1.8.3.js"></script>
<script type="text/javascript">
$(document).ready(function(){
$("#add").click(function(){
$("div").data("mydata","博客園歡迎您");
});
$("#show").click(function(){
$("div").text($("div").data("mydata"));
});
$("#delete").click(function(){
$("div").removeData("mydata");
alert($("div").data("mydata"));
});
});
</script>
</head>
<body>
<div></div>
<button id="add">向元素添加數據</button>
<button id="show">顯示添加的數據</button>
<button id="delete">刪除元素中的數據</button>
</body>
</html>
依序操作三個按鈕:先附加資料、再顯示(會看到文字出現在 div 中)、最後刪除。刪除後 alert 會跳出 undefined,這就是資料已不存在的訊號。要注意的是,removeData() 只清除資料,元素本身與它上面的文字內容都不會被影響。
在單頁應用中,元素可能被反覆建立與銷毀。若 data() 掛上去的物件裡又參照了其他 DOM 節點或大型結構,長期累積下來容易造成記憶體無法回收。因此常見的做法是在移除元素之前先呼叫一次無參數的 removeData(),或在元件卸載的清理函式中統一處理。