jQuery Tutorial Tutorials - jQuery .prop() method

The .prop() method in jQuery is used to get the value of a property for the first element in the set of matched elements or set one or more properties for every matched element.

jQuery .prop() method Syntax

.prop([propertyName[,value|function]|[properties])

// That is

.prop(propertyName)
.prop(propertyName,value)
.prop(propertyName,function)
.prop(properties)

.prop(propertyName)

Get the value of a property for the first element in the set of matched elements.

example

return true if the element is checked,otherwise return false

$('input[type="checkbox"').prop('checked');

Try now

.prop(propertyName,value)

Add/Set a simple property for the set of matched elements.

example

Disable and check all checkboxes on the page.

$( "input" ).prop( "disabled", false );
$( "input" ).prop( "checked", true );

Try now

.prop(propertyName,function)

Add/Set a simple property for the set of matched elements.
function will return a value to set for the property.

example

if the function return nothing or undefined. the checked value won't be changed.

//to toggle all checkboxes based off their individual values
$( "input[type='checkbox']" ).prop( "checked", function( i, val ) {
  return !val;
});

Try now

.prop(properties)

Add/Set one or more properties for the set of matched elements.

properties is an object of prop-value pairs,for example:
{ disabled: true } ,
{ disabled: true, checked: false }.

example

Set the properties for all checkboxs.

$( "input[type='checkbox']" ).prop({  disabled: true});

Try now

Attributes vs. Properties

For <input type="checkbox" checked="checked" />