Internals/API/jQuery
jQuery.data(elem, name, value)
要素に紐づいたデータを設定し、新たに設定された値を返します。
このAPIは、要素ごとに付随した情報を持たせたい場合などに非常に有用です。
例えば地図上にマーカーを配置するような場合、マーカーとして用いるimg要素にデータを付随させることで、特別な拡張が無くても様々な情報を保持させることができます。
ここで設定する値は文字列には限らず、数値や配列など、どんな型であっても受け入れられます。
プラグインで要素に固有の値を持たせる場合、コンフリクトしないようにプラグイン名を用いて、オブジェクトでデータを保持するのが良いでしょう。
このAPIは、要素ごとに付随した情報を持たせたい場合などに非常に有用です。
例えば地図上にマーカーを配置するような場合、マーカーとして用いるimg要素にデータを付随させることで、特別な拡張が無くても様々な情報を保持させることができます。
ここで設定する値は文字列には限らず、数値や配列など、どんな型であっても受け入れられます。
プラグインで要素に固有の値を持たせる場合、コンフリクトしないようにプラグイン名を用いて、オブジェクトでデータを保持するのが良いでしょう。
var obj = jQuery.data($("#target").get(0), "your_plugin_name", { ... });サンプル
サンプル1
要素の値を設定して、表示します。
<div> The values stored were <span></span> and <span></span> </div>
var adiv = $("div").get(0);
jQuery.data(adiv, "test", { first: 16, last: "pizza!" });
$("span:first").text(jQuery.data(adiv, "test").first);
$("span:last").text(jQuery.data(adiv, "test").last);
[全コードを表示]
[実行結果を単体で表示]