Método jQuery prop()
Exemplo
Adicione e remova uma propriedade chamada "color":
$("button").click(function(){
var $x = $("div");
$x.prop("color", "FF0000");
$x.append("The color property: " + $x.prop("color"));
$x.removeProp("color");
});
Definição e uso
O método prop() define ou retorna propriedades e valores dos elementos selecionados.
Quando esse método é usado para retornar o valor da propriedade, ele retorna o valor do PRIMEIRO elemento correspondido.
Quando esse método é usado para definir valores de propriedade, ele define um ou mais pares de propriedade/valor para o conjunto de elementos correspondentes.
Nota: O método prop() deve ser usado para recuperar valores de propriedade, por exemplo, propriedades DOM (como tagName, nodeName, defaultChecked) ou suas próprias propriedades personalizadas.
Dica: Para recuperar atributos HTML, use o método attr() .
Dica: Para remover uma propriedade use o método removeProp() .
Sintaxe
Retornar o valor de uma propriedade:
$(selector).prop(property)
Defina a propriedade e o valor:
$(selector).prop(property,value)
Defina a propriedade e o valor usando uma função:
$(selector).prop(property,function(index,currentvalue))
Defina várias propriedades e valores:
$(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
|
Experimente você mesmo - Exemplos
prop() e attr() pode retornar valores diferentes. Este exemplo mostra as diferenças quando usado para retornar o status "marcado" de uma caixa de seleção.