easy

DocsVersion : 1.0.0

data( name, [ val ] )

原型方法Define in : data.js

写入和读取该匹配元素的缓存数据。初次写入数据时会在该 DOM 元素上定义一个以 euid 为 key 的 property,此 porperty 的属性值就是访问 E.cache 中的缓存的索引值。这样就可以尽量避免在 DOM 元素上存储数据( 直接在 DOM 元素上存放大量数据可能会引起内存泄漏 )。

无 val 参数,返回第一个匹配元素的缓存数据。有 val 参数,则设置所有匹配元素的缓存数据。

参数
  • name
    String | Object
    必需

    缓存数据的属性名。也可以是 key / value 形式的参数,这样可以一次缓存多个。

  • val
    Anything
    可选

    任意类型的缓存数据。无该参数,则是读取缓存,有该参数则是写入缓存,写入缓存是可以覆盖的。

返回值
  • easyJS Object

    val 参数不为空时,是写入缓存,写入缓存时其返回值是 easyJS Object。

  • Anything

    val 参数为空时,是读取缓存,读取缓存时其返回值就是缓存数据。

例子1

将一个对象写入到 div 元素的缓存中。

HTML代码:
<div></div>
Javascript代码:
E( 'div' ).data( 'testData', { foo : 'bar' } );

读取该数据。

Javascript代码:
E( 'div' ).data( 'testData' ); // { foo : 'bar' }