Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

:valid — sélecteur de validité des données

La pseudo-classe CSS `:valid` sélectionne les contrôles soumis à la validation des contraintes qui respectent ces contraintes. Elle sélectionne aussi les formulaires sans contrôle associé invalide et les éléments `fieldset` sans contrôle descendant invalide. Aucune interaction préalable de l’utilisateur n’est nécessaire.

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

Syntaxe

:valid

:valid est une pseudo-classe sans argument : écrivez-la sans parenthèses, par exemple input:valid. En HTML, elle correspond aux éléments soumis à la validation des contraintes qui respectent ces contraintes, ainsi qu’aux formulaires et aux éléments fieldset dans les conditions décrites ci-dessous. Elle permet de mettre en forme les champs valides, mais ne définit pas elle-même de règles de validation.

Le résultat dépend notamment de required, type, pattern et d’une erreur personnalisée définie avec setCustomValidity(). Un champ facultatif type="email" vide peut être valide ; :valid ne signifie donc pas « renseigné ». Cette pseudo-classe n’équivaut pas non plus à :not(:invalid) : un élément qui n’est pas soumis à la validation des contraintes peut ne correspondre à aucune de ces deux pseudo-classes de validité.

form:valid correspond à un formulaire si aucun de ses contrôles associés soumis à la validation des contraintes n’enfreint ses contraintes. C’est également le cas si aucun contrôle associé n’est soumis à cette validation.

fieldset:valid correspond à un élément fieldset si aucun de ses descendants soumis à la validation des contraintes n’enfreint ses contraintes. L’élément fieldset lui-même n’a pas besoin d’être soumis à cette validation pour correspondre au sélecteur.

:valid peut s’appliquer dès le chargement de la page ; :user-valid tient également compte d’un état lié à l’interaction de l’utilisateur.

Dans l’exemple, A12 respecte pattern, mais pas B12 ; le formulaire entier ne correspond donc pas à :valid. La bordure est actualisée en fonction de l’état du champ, mais le texte de diagnostic n’est calculé qu’une seule fois. Ne communiquez pas la validité uniquement par la couleur et ne considérez pas la validation du navigateur comme un remplacement de la validation côté serveur.

Exemples

<!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>

Résultat

a: true
b: false
codes: false

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources