CKTIS / CSS
:user-invalid — champs invalides après interaction
La pseudo-classe :user-invalid sélectionne les contrôles de formulaire invalides seulement après une interaction qui justifie l’affichage d’une erreur, par exemple une tentative d’envoi du formulaire. Elle évite ainsi de signaler comme erronés les champs encore intacts dès l’ouverture de la page.
Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntaxe
:user-invalid:user-invalid est une pseudo-classe sans argument. En HTML, elle correspond aux éléments input, textarea et select qui sont soumis à la validation des contraintes, ne respectent pas ces contraintes et dont l’état interne user validity est défini sur true. Le nom de cet état ne signifie pas que la valeur est valide.
Contrairement à :invalid, elle tient compte de l’historique des interactions : un champ vide avec required peut être invalide au chargement sans correspondre encore à :user-invalid. Une tentative d’envoi du formulaire est un moment important pour révéler les erreurs ; ne supposez toutefois pas que le simple fait de recevoir puis de perdre le focus suffit toujours. Les détails d’une activation plus précoce dépendent des règles HTML et du navigateur.
Tout élément correspondant à :user-invalid correspond également à :invalid. En revanche, :user-valid concerne les saisies valides après une interaction appropriée ; ce n’est pas la simple négation de :user-invalid, car un champ intact peut ne correspondre à aucune des deux.
L’exemple associe une bordure à un texte d’erreur plutôt que de s’appuyer uniquement sur la couleur. CSS réagit à l’état de validation, mais ne définit pas lui-même les contraintes et ne remplace pas la validation des données côté serveur.
Exemples
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Showing errors with :user-invalid</title>
<style>
input { border: 2px solid #555; }
input:user-invalid { border-color: #b00020; }
.error { display: none; }
input:user-invalid + .error { display: block; }
</style>
</head>
<body>
<form id="demo">
<label for="email">Email (required)</label>
<input id="email" type="email" required aria-describedby="email-error">
<p id="email-error" class="error">Enter a valid email address.</p>
<button type="submit">Check</button>
<button type="reset">Reset</button>
</form>
<script>
const form = document.querySelector('#demo');
const field = document.querySelector('#email');
const error = document.querySelector('#email-error');
// Keep validation local, even if the field contains a valid address.
form.addEventListener('submit', event => event.preventDefault());
field.addEventListener('invalid', event => event.preventDefault());
function report(stage) {
const visible = getComputedStyle(error).display !== 'none';
console.log(`${stage}: :invalid=${field.matches(':invalid')}, :user-invalid=${field.matches(':user-invalid')}, error=${visible ? 'visible' : 'hidden'}`);
}
report('Before validation');
form.requestSubmit();
report('After empty submit attempt');
form.reset();
report('After reset');
</script>
</body>
</html>Résultat
Before validation: :invalid=true, :user-invalid=false, error=hidden After empty submit attempt: :invalid=true, :user-invalid=true, error=visible After reset: :invalid=true, :user-invalid=false, error=hidden
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.