Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

:invalid — um elemento que não cumpre as restrições de validação

A pseudoclasse CSS :invalid corresponde aos elementos que não cumprem as restrições de validação de dados. Permite realçar valores inválidos ou campos obrigatórios vazios, mesmo antes de o utilizador interagir com eles.

Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Sintaxe

:invalid

:invalid é uma pseudoclasse, não uma indicação de erros de sintaxe do seletor. Em HTML, corresponde aos controlos sujeitos à validação de restrições que não as cumprem. O seletor input:invalid limita as correspondências aos elementos input.

A correspondência pode ocorrer de imediato: um campo vazio com required não exige que o formulário tenha sido enviado anteriormente. :user-invalid também tem em conta o estado de validade relacionado com a interação do utilizador; não é outro nome para :invalid. Os elementos sem semântica de validação não correspondem nem a :invalid nem a :valid, pelo que :not(:valid) não é equivalente a :invalid.

HTML abrange também contentores: form:invalid corresponde a um formulário que contém pelo menos um controlo inválido elegível para validação, enquanto fieldset:invalid corresponde a um grupo com um descendente desse tipo. Isto não significa que qualquer antecessor de um campo inválido corresponda ao seletor.

O exemplo verifica um campo obrigatório vazio e o valor Ada e, em seguida, repõe o valor vazio. O texto esperado é apresentado separadamente; o exemplo requer verificação local. Numa interface, não dependa apenas da cor: apresente uma mensagem de erro compreensível.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>:invalid example</title>
<style>
  input:invalid { outline: 3px solid crimson; }
</style>
<label for="name">Name (required)</label>
<input id="name" required autocomplete="off">
<pre id="result"></pre>
<script>
  const input = document.getElementById('name');
  const results = [];
  input.value = '';
  results.push(`empty: ${input.matches(':invalid')}`);
  input.value = 'Ada';
  results.push(`filled: ${input.matches(':invalid')}`);
  input.value = '';
  document.getElementById('result').textContent = results.join('\n');
</script>
</html>

Resultado

empty: true
filled: false

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.

Fontes