任意のデータをマッチした要素に紐付けて、取得・設定する仕組みを提供します。

• .data( key, value ) 1.2.3追加
• .data( obj ) 1.4.3追加
• .data( key ) 1.2.3追加
• .data( ) 1.4追加

.data( key, value ) 1.2.3追加

要素に対して、キーと格納するデータを指定します。

引数	説明
key	要素に紐付けるデータのキーとなる文字列を指定します。
value	格納するデータを指定します。 このデータは配列、オブジェクトを含むいくつかのjavaScriptの型の値を指定することが可能です。

$('body').data('foo', 52);
$('body').data('foo'); // 52を取得

.data( obj ) 1.4.3追加

キーと値の組み合わせのオブジェクトを指定して、要素に紐付くデータを更新します。

引数	説明
obj	キーと値のペアのオブジェクトを指定して、要素にデータを一括で紐付けます。

$('body').data('bar', { myType: 'test', count: 40 });
// {foo:52, bar:{ myType:'test', count:40}}のオブジェクトデータを取得
$('body').data();

.data( key ) 1.2.3追加

指定したキーで格納されているデータを取得します。

引数	説明
key	要素に紐付いているキーを指定して、データを取得します。

alert( $("body").data("foo")); //undefined
$("body").data("bar", "foobar");
alert( $("body").data("bar")); //foobar

.data( ) 1.4追加

要素に格納されているデータをキーと値の組み合わせのオブジェクトで取得します。

$('body').data('bar', { myType: 'test', count: 40 });
// {foo:52, bar:{ myType:'test', count:40}}のオブジェクトデータを取得
$('body').data();

 Back to top