data([key], [value])
version 1.2.3 以降
解説
setter
マッチした要素に、任意のデータを関連付けます。
引数
-
[key]オプション
String: データのキー
-
[value]オプション
Object: データ
-
[Object]オプション (version 1.4 から)
Object: データ(キーと値のハッシュ)
戻り値
getter
マッチした要素に関連付けたデータを取得します。
引数
-
[key]オプション
String: データのキー
戻り値
-
Object: キーに対応する関連付けたオブジェクト。キーを省略した場合は、要素に関連付けられているオブジェクト。
例
「data」ボタンを押すと、p 要素に "p_data_key" というキーで "data associated !" というデータを関連付けます。
「removeData」ボタンを押すと、p 要素に関連付けたデータを削除します。
p 要素をクリックして、関連付けられたデータを表示してみてください。
$("#test_result p").click(function(){
alert($(this).data("p_data_key"));
});
$("#data").click(function(){
$("#test_result p").data("p_data_key", "data associated !");
});
$("#removeData").click(function(){
$("#test_result p").removeData("p_data_key");
});
|