CKTIS / HTML
required — campo obrigatório do formulário
O atributo booleano `required` exige que um controlo de formulário compatível seja preenchido. Aplica-se a `input`, `select` e `textarea`; a forma de cumprir o requisito depende do tipo de controlo.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
input: required
select: required
textarea: required
Boolean forms: required | required="" | required="required"required é um atributo booleano: a sua presença ativa o requisito e a sua remoção desativa-o. As formas required, required="" e required="required" são equivalentes. Escrever required="false" não está em conformidade e, ainda assim, ativa o requisito.
Nos controlos input de texto compatíveis e em textarea, um valor vazio causa validity.valueMissing. Num campo de texto normal, só os espaços podem satisfazer required; o atributo não verifica se o conteúdo é significativo. Uma checkbox obrigatória tem de estar selecionada. Num grupo radio, tem de estar selecionado um elemento se algum tiver required, e um controlo file precisa de um ficheiro. required não se aplica aos tipos hidden, range, color nem a botões.
Num select, se não estiver selecionada nenhuma opção ou se estiver selecionada apenas a opção que serve de marcador de posição, considera-se que falta um valor. Um select obrigatório sem multiple e com tamanho de apresentação 1 tem de incluir essa opção. O primeiro elemento option da lista de opções tem de ter um valor vazio e ser filho direto de select, não estar dentro de um optgroup. Uma opção com valor vazio que apareça mais adiante na lista não serve de marcador de posição.
Os controlos disabled e os controlos que suportam readonly e têm esse atributo não participam na validação de restrições. Os controlos inválidos impedem o envio normal do formulário, mas novalidate, formnovalidate ou form.submit() podem ignorar essa etapa. Valide também os dados no servidor e indique o requisito numa etiqueta visível.
O exemplo chama checkValidity() antes e depois de preencher os três controlos. O resultado esperado é primeiro false e depois true; não depende do idioma das mensagens de validação do navegador.
Exemplos
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>required</title>
<form id="form">
<label>Name (required): <input id="name" name="name" required></label>
<label>Plan (required):
<select id="plan" name="plan" required>
<option value="">Choose</option>
<option value="basic">Basic</option>
</select>
</label>
<label>Note (required): <textarea id="note" name="note" required></textarea></label>
</form>
<pre id="result"></pre>
<script>
const form = document.getElementById('form');
const before = form.checkValidity();
document.getElementById('name').value = 'Ada';
document.getElementById('plan').value = 'basic';
document.getElementById('note').value = 'Hello';
const after = form.checkValidity();
document.getElementById('result').textContent = before + '\n' + after;
</script>
</html>Resultado
false true
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.