Método prop

O método prop permite obter e alterar a propriedade de um elemento. É importante não confundir propriedades e atributos dos elementos. Ao criar a árvore DOM, os atributos são convertidos nas propriedades DOM correspondentes dos elementos. Seus nomes nem sempre coincidem, assim como seus valores. Algumas propriedades também podem não ter atributos correspondentes, elas podem ser obtidas e definidas apenas usando o método prop, por exemplo, a propriedade tagName. Para obter os atributos de um elemento, use o método attr.

Sintaxe

Obtendo o valor de uma propriedade:

$(seletor).prop(nome da propriedade);

Alterando o valor de uma propriedade:

$(seletor).prop(nome da propriedade, novo valor);

Alterando os valores de várias propriedades:

$(seletor).prop({primeira_propriedade: novo_valor, segunda_propriedade: novo_valor, ...});

Aplicando uma função a cada elemento no conjunto:

$(seletor).prop(nome da propriedade, function(índice no conjunto, valor atual da propriedade));

Exemplo

No exemplo a seguir, obteremos um parágrafo pelo seu id e exibiremos na tela o valor de sua propriedade className:

<p id="test" class="aaa">texto</p>

let value = $('#test').prop('className');
console.log(value);

Exemplo

Vamos alterar simultaneamente as propriedades para className e disabled:

<input type="checkbox" class="aaa" id="test" /> $("#test").prop({ className: 'bbb', disabled: 'true' });

Veja também

método removeProp,
que permite remover propriedades de elementos
método attr,
que permite trabalhar com atributos de elementos