jQuery.data()メソッド
例
div 要素にデータを保存してから取得する
<div>
保存された値は
<span></span>
と
<span></span>
</div>
<script>
$(function () {
var div = $( "div" )[ 0 ];
jQuery.data( div, "test", {
first: 16,
last: "pizza!"
});
$( "span:first" ).text( jQuery.data( div, "test" ).first );
$( "span:last" ).text( jQuery.data( div, "test" ).last );
})
</script>
試してみる »
定義と使い方
$.data() 関数は、指定した要素にデータを保存・取得するために使用され、設定値を返します。
ヒント:1. これは低レベルメソッドであり、.data() メソッドの方が便利です。
2. data() 関数で保存・取得するデータはすべて一時データであり、ページが更新されると、以前に保存したデータはすべて削除されます。
3. このメソッドは現在、XMLドキュメント上でのクロスプラットフォーム設定を提供していません。Internet Explorer は XMLドキュメント内でカスタム属性によるデータの追加を許可していません。
構文
用法 1
$.data( element, key, value )
注意:1. data() 関数で保存・取得するデータはすべて一時データであり、ページが更新されると、以前に保存したデータはすべて削除されます。
2. undefined は認識されないデータ値です。jQuery.data( el, "name", undefined ) を呼び出すと、対応する "name" データが返され、jQuery.data(el, "name") と同等です。
1つの要素に異なる値を設定し、それらの値を取得できます:
jQuery.data(document.body, 'foo', 52); jQuery.data(document.body, 'bar', 'test');
用法 2
$.data( element, key )
1つの要素に異なる値を設定し、それらの値を取得できます:
alert(jQuery.data( document.body, 'foo' )); alert(jQuery.data( document.body ));
| パラメータ | 説明 |
|---|---|
| element | Element型 データを保存するDOMオブジェクト |
| key | 任意。String型 指定されたキー名の文字列。 |
| value | 任意。Object型 保存する任意の型のデータ。 |
その他の例
データを取得
要素に保存されている "blah" という名前のデータを取得します。
その他の拡張
jQuery 雑多メソッド