data([key], [value])

解説

マッチした要素に、任意のデータを関連付けます。

引数

• [key]オプション
  String: データのキー
• [value]オプション
  Object: データ

• [Object]オプション (version 1.4 から)
  Object: データ（キーと値のハッシュ）
  

戻り値

• jQuery: jQuery オブジェクト

マッチした要素に関連付けたデータを取得します。

引数

• [key]オプション
  String: データのキー

戻り値

• Object: キーに対応する関連付けたオブジェクト。キーを省略した場合は、要素に関連付けられているオブジェクト。

例

「data」ボタンを押すと、p 要素に "p_data_key" というキーで "data associated !" というデータを関連付けます。
「removeData」ボタンを押すと、p 要素に関連付けたデータを削除します。

p 要素をクリックして、関連付けられたデータを表示してみてください。

// P要素をクリック
$("#test_result p").click(function(){
    alert($(this).data("p_data_key"));
});

// data ボタンをクリック
$("#data").click(function(){
    $("#test_result p").data("p_data_key", "data associated !");
});

// removeData ボタンをクリック
$("#removeData").click(function(){
    $("#test_result p").removeData("p_data_key");
});

ページトップヘ

ページトップヘ