CKTIS / HTML
checked: seleção predefinida e seleção atual
Compreende as predefinições de caixas e botões de opção, as alterações e a reposição do formulário.
Versão: HTML Living Standard
Sintaxe
<input type="checkbox" name="topic" value="html" checked>O atributo booleano checked dá a uma caixa de verificação ou a um botão de opção o estado selecionado predefinido. O que conta é a presença, pelo que checked="false" continua a indicar uma predefinição selecionada. Os botões de opção do mesmo grupo permitem apenas uma seleção atual; uma caixa de verificação é selecionável independentemente. Este atributo não define o valor predefinido dos campos de texto normais.
Depois da interação, distingue a propriedade DOM atual checked de defaultChecked, que reflete o atributo predefinido. Alterar o atributo não substitui de forma fiável a alteração do estado atual depois de o controlo ter sido modificado. Repor o formulário restaura as predefinições. Uma caixa não selecionada é omitida dos dados normais do formulário, em vez de ser enviada como o booleano false.
O exemplo começa selecionado, ativa o controlo para o desselecionar, inspeciona os campos enviados e repõe o formulário. O resultado demonstra a omissão durante a desseleção e a restauração da seleção predefinida. O estado visual misto de uma caixa é uma propriedade separada controlada por script, não um terceiro valor do atributo.
Exemplos
<!doctype html><meta charset="utf-8">
<form id="form"><label><input id="topic" type="checkbox" name="topic" value="html" checked> HTML</label></form>
<output id="result"></output><script>
const field = document.querySelector('#topic'), form = document.querySelector('#form');
const initial = field.checked;
field.click();
const afterClick = field.checked, submitted = new FormData(form).has('topic');
form.reset();
document.querySelector('#result').textContent = 'initial=' + initial + '; afterClick=' + afterClick + '; submitted=' + submitted + '; afterReset=' + field.checked + '; default=' + field.defaultChecked;
</script>Resultado
initial=true; afterClick=false; submitted=false; afterReset=true; default=true
A verificação dos dados do formulário trata da presença do campo com nome, não de o seu valor textual ser igual a true.