CKTIS / CSS
:user-invalid — ungültige Felder nach einer Interaktion
Die Pseudoklasse :user-invalid wählt ungültige Formularsteuerelemente erst dann aus, wenn eine Interaktion das Anzeigen eines Fehlers rechtfertigt, etwa ein versuchtes Absenden des Formulars. So werden unberührte Felder nicht sofort beim Öffnen der Seite als fehlerhaft markiert.
Version: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntax
:user-invalid:user-invalid ist eine Pseudoklasse ohne Argumente. In HTML trifft sie auf input-, textarea- und select-Elemente zu, die der Constraint Validation unterliegen, deren Bedingungen nicht erfüllen und deren interner Zustand user validity auf true gesetzt ist. Der Name dieses Zustands bedeutet nicht, dass der Wert gültig ist.
Anders als :invalid berücksichtigt sie den bisherigen Interaktionsverlauf: Ein leeres Feld mit required kann bereits beim Laden ungültig sein, ohne schon auf :user-invalid zu passen. Ein Absendeversuch ist ein wichtiger Zeitpunkt, um Fehler sichtbar zu machen; gehe jedoch nicht davon aus, dass bloßes Erhalten und Verlieren des Fokus immer ausreicht. Die Einzelheiten einer früheren Aktivierung hängen von den HTML-Regeln und dem Browser ab.
Jedes Element, auf das :user-invalid zutrifft, passt auch auf :invalid. :user-valid betrifft dagegen gültige Eingaben nach einer entsprechenden Interaktion; es ist nicht einfach die Verneinung von :user-invalid, denn ein unberührtes Feld kann auf keine der beiden Pseudoklassen passen.
Das Beispiel kombiniert einen Rahmen mit Fehlertext, statt sich allein auf Farbe zu verlassen. CSS reagiert auf den Validierungszustand, legt aber selbst keine Bedingungen fest und ersetzt keine serverseitige Datenprüfung.
Beispiele
<!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>Ergebnis
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
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.