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

CKTIS / CSS

:valid — seletor de validade dos dados

A pseudoclasse CSS `:valid` seleciona controlos sujeitos à validação de restrições que cumprem essas restrições. Também seleciona formulários sem controlos associados inválidos e elementos `fieldset` sem controlos descendentes inválidos. Não exige uma interação prévia do utilizador.

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

Sintaxe

:valid

:valid é uma pseudoclasse sem argumentos: escreve-se sem parênteses, por exemplo, input:valid. Em HTML, corresponde a elementos sujeitos à validação de restrições que cumprem essas restrições, bem como a formulários e elementos fieldset nas condições descritas abaixo. Pode aplicar estilos a campos válidos, mas não define, por si só, regras de validação.

O resultado depende, entre outros fatores, de required, type, pattern e de um erro personalizado definido através de setCustomValidity(). Um campo opcional vazio com type="email" pode ser válido, pelo que :valid não significa «preenchido». Também não equivale a :not(:invalid): um elemento que não esteja sujeito à validação de restrições pode não corresponder a nenhuma das duas pseudoclasses de validade.

form:valid corresponde a um formulário se nenhum dos seus controlos associados sujeitos à validação de restrições violar as respetivas restrições. Isto inclui formulários sem controlos associados sujeitos a essa validação.

fieldset:valid corresponde a um elemento fieldset se nenhum dos seus descendentes sujeitos à validação de restrições violar as respetivas restrições. O próprio fieldset não tem de estar sujeito a essa validação para corresponder ao seletor.

:valid pode aplicar-se logo ao carregar a página; :user-valid tem ainda em conta um estado relacionado com a interação do utilizador.

No exemplo, A12 cumpre pattern, mas B12 não, pelo que o formulário inteiro não corresponde a :valid. O contorno é atualizado de acordo com o estado do campo, mas o texto de diagnóstico só é calculado uma vez. Não comuniques a validade apenas através da cor e não consideres a validação do navegador um substituto da validação do lado do servidor.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>:valid example</title>
<style>
  input { border: 3px solid gray; }
  input:valid { border-color: green; }
</style>
<form id="codes">
  <label>Code A <input id="a" required pattern="A[0-9]{2}" value="A12"></label>
  <label>Code B <input id="b" required pattern="A[0-9]{2}" value="B12"></label>
</form>
<pre id="result"></pre>
<script>
  const a = document.getElementById('a');
  const b = document.getElementById('b');
  const codes = document.getElementById('codes');
  document.getElementById('result').textContent = [
    `a: ${a.matches(':valid')}`,
    `b: ${b.matches(':valid')}`,
    `codes: ${codes.matches(':valid')}`
  ].join('\n');
</script>
</html>

Resultado

a: true
b: false
codes: 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