jQuery prop() Method
jQuery HTML/CSS MethodsExample
Add and remove a property named "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 »
Definition and Usage
The prop() method sets or returns properties and values of the selected elements.
When this method is used to return the property value, it returns the value of the FIRST matched element.
When this method is used to set property values, it sets one or more property/value pairs for the set of matched elements.
Note: The prop() method should be used to retrieve property values, e.g. DOM properties (like tagName, nodeName, defaultChecked) or your own custom made properties.
Tip: To retrieve HTML attributes, use the attr() method instead.
Tip: To remove a property use the removeProp() method.
Syntax
Return the value of a property:
$(selector).prop(property)
Set the property and value:
$(selector).prop(property,value)
Set property and value using a function:
$(selector).prop(property,function(index,currentvalue))
Set multiple properties and values:
$(selector).prop({property:value, property:value,...})
| Parameter | Description |
|---|---|
| property | Specifies the name of the property |
| value | Specifies the value of the property |
| function(index,currentvalue) | Specifies a function that returns the property value to set
|
Try it Yourself - Examples
Difference between prop() and attr()
prop() and attr() might return different values. This example shows the differences when used to return
the "checked" status of a checkbox.
