jQuery.removeData() 函數用法詳解

removeData()函數用來移除在目前jQuery物件所符合的每一個元素上儲存的指定鍵名的資料項。

removeData()函數主要用來移除透過data()函數存放的資料。

此函數屬於jQuery物件(實例)。

語法

removeData()函數的語法如下：

jQueryObject.removeData( keys )

注意：removeData( )會移除目前jQuery物件所匹配的每一個元素上指定鍵名的資料。

參數

參數 描述

keys String/Array類型指定的鍵名字串或陣列。

如果要同時移除多個鍵名的資料項，請傳入數組形式的參數，數組的每個元素就是需要移除的鍵名字串。你也可以傳入以空格分隔的字串，空格隔開的每個子字串即是需要移除的鍵名字串。

如果參數keys是包含空格的字串，例如"a b c"，則removeData()將先判斷是否存在鍵名為"a b c"(字串本身)的資料項，如果存在則移除該數據，並且不再執行後續的分割等操作。若不存在，才會依空格分割，移除鍵名分別為"a"、"b"、"c"(分割後的子字串)的資料項。

如果你存放資料的鍵名中包含空格(例如"a b")，此時使用removeData()同時移除多個鍵名的資料項(例如"a b c d"，其中"a b"是一個鍵名)，將無法成功移除包含空格的鍵名(例如"a b")。你可以改用數組形式，或是針對包含空格的鍵名進行單獨移除。

傳回值

removeData()函數的回傳值是jQuery類型，傳回目前jQuery物件本身。

範例&說明

以下面這段HTML程式碼為例：

   

       

           

• #;/li id="n4"&it1
#; ;li id="n5">item2

           

• item3
o#  #  >item3

>

   

 

我們寫如下jQuery程式碼：

##var $li = $("li");

// 同時儲存資料到所有的li元素

$li.data("name", "CodePlayer");

$li.data("desc", "專注於程式開發技術分享");

$li.data("url", "http://www.365mini.com/");

// 同時移除所有li元素上的鍵名為name的資料

$li.removeData("name");

var $n5 = $("#n5"); // 透過n4、n5、 n6都可以讀取資料

//  傳回鍵值name所對應的資料

document

.writeln( $n5.data("name") ); / / undefined

var $n4 = $("#n4");// 找不到鍵名為"desc url"的資料項，接著根據空格進行分割

#// 移除鍵名為"desc"、"url"的資料項目

$n4.removeData("desc url");

document.writeln( $n4. data("desc") ); // undefined

document.writeln( $n4.data("url") ); // undefined

$li.data("a", "測試a");

$li.data("b", "測試b");

$li.data("a b", "測試a b");

//只會移除鍵名為"a b"的資料項

$li.removeData("a b");

document.writeln( $li.data( "a") ); // 測試a

document.writeln( $li.data("b") ); // 測試b

以上是jQuery.removeData() 函數用法詳解的詳細內容。更多資訊請關注PHP中文網其他相關文章！