jQuery prop() Method

## jQuery Tutorial

jQuery HOME jQuery Intro jQuery Install jQuery Syntax jQuery Selectors jQuery Events

## jQuery Effects

jQuery Hide/Show jQuery Fade jQuery Slide jQuery Animate jQuery stop() jQuery Callback jQuery Chaining

## jQuery HTML

jQuery Get jQuery Set jQuery Add jQuery Remove jQuery CSS Classes jQuery css() jQuery Dimensions

## jQuery Traversing

jQuery Traversing jQuery Ancestors jQuery Descendants jQuery Siblings jQuery Filtering

## jQuery AJAX

jQuery AJAX Intro jQuery Load jQuery Get/Post

## jQuery Misc

jQuery noConflict()

## jQuery Examples

jQuery Examples jQuery Quiz jQuery Certificate

## jQuery References

jQuery Selectors jQuery Events jQuery Effects jQuery HTML/CSS jQuery Traversing jQuery AJAX jQuery Misc jQuery Properties

# jQuery prop() Method

jQuery HTML/CSS Methods

## Example

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

- index - Receives the index position of the element in the set
- currentvalue - Receives the current property value of selected elements

## 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.

jQuery HTML/CSS Methods

## Your suggestion:

Your E-mail (optional):

Page address:

Description:

Close [X]

## Thank You For Helping Us!

Your message has been sent to W3Schools.

Close [X]
Search w3schools.com:

## WEB HOSTING

Best Web Hosting UK Reseller Hosting Wow! $5 SSD Hosting

## WEB BUILDING

Download XML Editor
FREE Website BUILDER FREE Website Creator

## WEB RESOURCES

Web Statistics Web Validation

## SHARE THIS PAGE