jQuery prop() metodo

❮ Metodi jQuery HTML/CSS

Esempio

Aggiungi e rimuovi una proprietà denominata "color":

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

Definizione e utilizzo

Il metodo prop() imposta o restituisce proprietà e valori degli elementi selezionati.

Quando questo metodo viene utilizzato per restituire il valore della proprietà, restituisce il valore del PRIMO elemento corrispondente.

Quando questo metodo viene utilizzato per impostare i valori delle proprietà, imposta una o più coppie proprietà/valore per l'insieme di elementi corrispondenti.

Nota: il metodo prop() deve essere utilizzato per recuperare i valori delle proprietà, ad esempio le proprietà DOM (come tagName, nodeName, defaultChecked) o le proprie proprietà personalizzate.

Suggerimento: per recuperare gli attributi HTML, utilizzare invece il metodo attr() .

Suggerimento: per rimuovere una proprietà, utilizzare il metodo removeProp() .


Sintassi

Restituisce il valore di una proprietà:

$(selector).prop(property)

Imposta la proprietà e il valore:

$(selector).prop(property,value)

Imposta proprietà e valore usando una funzione:

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

Imposta più proprietà e valori:

$(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

Provalo tu stesso - Esempi


prop() e attr() potrebbe restituire valori diversi. Questo esempio mostra le differenze quando viene utilizzato per restituire lo stato "selezionato" di una casella di controllo.


❮ Metodi jQuery HTML/CSS