Propriedade de valor do Input Checkbox

Objeto Checkbox do DOM HTML Input

Definição e uso

value Definir ou retornar o valor da propriedade "value" do caixa de seleção.

Para os caixas de seleção, o conteúdo da propriedade "value" não aparecerá na interface do usuário. A propriedade "value" só tem significado ao submeter o formulário. Se o caixa de seleção estiver marcado ao submeter o formulário, o nome do caixa de seleção e o valor da propriedade "value" serão enviados juntos (se o caixa de seleção não estiver marcado, não será enviado nenhum informação).

Veja também:

Manual de referência HTML:Propriedade value do <input> do HTML

Exemplo

Exemplo 1

Retornar o valor da propriedade "value" do caixa de seleção:

var x = document.getElementById("myCheck").value;

Experimente pessoalmente

Exemplo 2

Alterar o valor associado ao caixa de seleção:

document.getElementById("myCheck").value = "newCheckboxValue";

Experimente pessoalmente

Exemplo 3

Submeter formulário - Como alterar o valor associado ao caixa de seleção:

document.getElementById("myCheck").value = "newCheckboxValue";
document.getElementById("demo").innerHTML = "O valor da propriedade "value" foi alterado. Tente submeter o formulário novamente.";

Experimente pessoalmente

Gramática

Retornar a propriedade value:

checkboxObject.value

Definir a propriedade value:

checkboxObject.value = text

Valor do atributo

Valor Descrição
text Define o valor associado ao input (também enviado ao submeter).

Detalhes técnicos

Retorno: Valor de string, que representa o valor da propriedade value do checkbox.

Suporte ao navegador

Chrome Edge Firefox Safari Opera
Chrome Edge Firefox Safari Opera
Suporte Suporte Suporte Suporte Suporte

Objeto Checkbox do DOM HTML Input