Método jQuery prop()

jQuery HTML/Métodos CSS

O método prop() obtém ou define atributos e valores do elemento selecionado.

ao usar o método prop()Obterao definir o valor do atributo, ele retornaráO primeiro elemento selecionadoo valor.

Usar o método prop()Definirao definir o valor do atributo, ele seráTodos os elementos selecionadosDefinir um ou mais atributos/par de valores.

Para obter ou definir atributos HTML, useattr()Método.

Para remover um atributo, useremoveProp()Método.

Sintaxe:

Obter valor do atributo:

$("selector").prop(property)

Definir atributo e valor:

$("selector").prop(property,　value)

Definir múltiplos atributos e valores:

$("selector").prop({property:value,　property:value,　...})

Definir atributo e valor usando função

$("selector").prop(property,　function(index,　currentValue))

Exemplo

Obter o valor da propriedade checked do checkbox:

$("input:checkbox").change(function(){
　　$("strong").text($(this).prop("checked"));
});

Definir o valor da propriedade selecionada do checkbox:

$("button").click(function(){
　　$("input:checkbox").prop("checked",　true);
});

Desativar todos os checkboxes na página:

$("document").ready(function(){
　　$("input:checkbox").prop("disabled",　true);
});

prop() e attr()

A diferença entre prop() e attr() pode ser importante em certos casos.

O método prop() oferece um método explícito para obter o valor do atributo, enquanto attr() obtém o atributo.

O seguinte exemplo mostra a diferença entre prop() e attr():

$("input:checkbox").change(function(){
　　$(this).prop("checked");
　　$(this).attr("checked");
});

Valor do Parâmetro

jQuery HTML/Métodos CSS