主要的方法如下:
. 代碼如下:
.data( key, value )
.data( obj )
.data( key )
.data()
從jQuery 1.4.3起, HTML 5 data- 屬性 將自動被引用到jQuery的數據對象中。
例如HTML:
. 代碼如下:<div data-role = "page" data-last-value = "43" data-hidden = "true" data-options = '{"name":"John"}' > </div>
下面的 jQuery代碼都是返回 true 的:
. 代碼如下:
$ ( "div" ) . data ( "role" ) === "page" ;
$ ( "div" ) . data ( "lastValue" ) === 43 ;
$ ( "div" ) . data ( "hidden" ) === true ;
$ ( "div" ) . data ( "options" ) . name === "John" ;
和html5的api不同的是,jQuery會嘗試將字符串轉換為一個JavaScript值(包括布爾值(booleans),數字(numbers),對象(objects),數組(arrays)和空(null))。如果這樣做不會改變數值的表示,那麼該值將轉換為一個數字(number)。例如,“1E02”和“100.000”是等同於數字(數字值100),但將轉換它們會改變他們的表示,所以他們被保留為字符串。字符串值“100”被轉換為數字100。
如果數據(data)屬性是一個對象(以“{”開始)或數組(以'[‘開始),可以用jQuery.parseJSON 將其解析成字符串;它必須遵循 有效的JSON的語法 ,包括帶雙引號的屬性名稱。如果該值不能解析為一個JavaScript值,它將被保留為字符串。
如果想將取出的屬性值直接當作字符串的話,請使用 attr() 方法。
data-屬性是在第一次使用這個數據屬性後不再存取或改變(所有的數據值都在jQuery內部存儲)。
調用 .data() 時如果不帶參數,將會以 JavaScript 對象的形式獲取所有數據。這個對象可以安全的存放在變量中,因為一旦這個新對象被提取出來,之後對元素進行的 .data(obj) 操作,將不會再影響這個對象。另外,直接操作這個對象會比每次調用 .data() 來設置或獲取值要快一些。