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

CKTIS / CSS

:user-valid — champ valide après une interaction de l’utilisateur

La pseudo-classe :user-valid sélectionne les champs de formulaire valides uniquement lorsque la condition d’interaction de l’utilisateur est remplie. Contrairement à :valid, elle n’indique pas automatiquement qu’un champ intact est valide.

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

Syntaxe

input:user-valid { /* declarations */ }

:user-valid est une pseudo-classe sans argument. En HTML, elle correspond aux éléments input, textarea et select qui sont soumis à la validation par contraintes, respectent leurs contraintes et dont l’état interne user validity est défini sur true.

:valid décrit la validité sans cette condition supplémentaire. Un champ dont la valeur initiale est valide peut donc correspondre à :valid, mais pas à :user-valid. Son opposé, :user-invalid, indique une invalidité une fois la condition d’interaction remplie ; ne pas lui correspondre ne signifie pas que le champ correspond à :user-valid.

Ne supposez pas que le simple fait de placer un contrôle au focus ou de lui affecter .value active cet état. Le moment précis de son activation pendant la modification peut dépendre du navigateur. Une tentative d’envoi du formulaire fournit un point de vérification clair, tandis qu’une réinitialisation efface l’état d’interaction.

L’exemple commence avec la valeur valide Ada. Cliquez sur Submit sans modifier la valeur, puis sur Reset. Le script empêche la navigation, pas la validation. Le texte à côté du champ complète la couleur de la bordure ; le sélecteur ne fait que mettre en forme un état et ne valide pas les données sur le serveur.

Exemples

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>:user-valid demo</title>
<style>
  input { border: 2px solid #666; padding: 0.4rem; }
  input:user-valid { border-color: #087a35; }
  .status::after { content: "Not user-valid"; }
  input:user-valid + .status::after { content: "User-valid"; }
</style>
<form id="demo">
  <label for="name">Name (required)</label>
  <input id="name" name="name" required value="Ada">
  <span class="status" aria-live="polite"></span>
  <button type="submit">Submit</button>
  <button type="reset">Reset</button>
</form>
<script>
  document.querySelector('#demo').addEventListener('submit', (event) => {
    event.preventDefault();
  });
</script>
</html>

Résultat

Initially: Not user-valid; gray border.
After Submit without editing: User-valid; green border.
After Reset: Not user-valid; gray border.

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