jQuery prop() メソッド

例

"color" という名前のプロパティを追加・削除する：

$("button").click(function(){
    var $x = $("div");
    $x.prop("color", "FF0000");
    $x.append("The color property: " + $x.prop("color"));
    $x.removeProp("color");
});

Try it Yourself »

定義と用法

prop() メソッドは、選択した要素のプロパティと値を設定するか、または返します。

このメソッドを、プロパティ値を返すために使用した場合、最初にマッチした要素のプロパティ値を返します。

このメソッドを、プロパティ値を設定するために使用した場合、マッチした全ての要素のプロパティ/値のペアを設定します。

注: prop() メソッドは、例えば（tagName、nodeName、defaultChecked などの）DOM プロパティ、または独自のカスタムメイド・プロパティのプロパティ値を取得するために使用すべきです。

チップ: HTML 属性を取得するには、代わりに attr() メソッドを使用します。

チップ: プロパティを削除するには、removeProp() メソッドを使用します。

構文

プロパティ値を返す：

$(selector).prop(property)

プロパティと値を設定する：

$(selector).prop(property,value)

関数を使用してプロパティと値を設定する：

$(selector).prop(property,function(index,currentvalue))

複数のプロパティと値を設定する：

$(selector).prop({property:value, property:value,...})

パラメータ	説明
property	プロパティの名前を指定する
value	プロパティの値を指定する
function(index,currentvalue)	選択した要素の新しいプロパティ値を設定する関数を指定する index - 集合における要素のインデックス位置を受け取る currentvalue - 選択した要素の現在のプロパティ値を返す

Try it Yourself - 例

prop() と attr() の違い1
prop() と attr() では異なる値を返す場合があります。この例は、チェックボックスの "checked" ステータスを返すために使用するときの違いを示します。

❮ jQuery HTML/CSS メソッド