CKTIS / CSS
:user-invalid — neispravna polja nakon interakcije
Pseudoklasa :user-invalid odabire neispravne kontrole obrasca tek nakon interakcije koja opravdava prikaz pogreške, primjerice pokušaja slanja obrasca. Time se izbjegava označavanje netaknutih polja kao pogrešnih odmah pri otvaranju stranice.
Verzija: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintaksa
:user-invalid:user-invalid je pseudoklasa bez argumenata. U HTML-u odgovara elementima input, textarea i select koji podliježu provjeri ograničenja, ne zadovoljavaju ta ograničenja i čije je interno stanje user validity postavljeno na true. Naziv tog stanja ne znači da je vrijednost valjana.
Za razliku od :invalid, uzima u obzir povijest interakcije: prazno polje s atributom required može biti neispravno pri učitavanju, a da još ne odgovara pseudoklasi :user-invalid. Pokušaj slanja obrasca važan je trenutak za prikaz pogrešaka; ipak, nemojte pretpostaviti da je samo dobivanje i gubitak fokusa uvijek dovoljno. Pojedinosti ranije aktivacije ovise o pravilima HTML-a i pregledniku.
Svaki element koji odgovara pseudoklasi :user-invalid odgovara i pseudoklasi :invalid. Nasuprot tome, :user-valid odnosi se na valjane podatke nakon odgovarajuće interakcije; nije jednostavno negiranje pseudoklase :user-invalid, jer netaknuto polje možda ne odgovara nijednoj od njih.
Primjer kombinira obrub s tekstom pogreške, umjesto da se oslanja samo na boju. CSS reagira na stanje provjere, ali sam ne definira ograničenja niti zamjenjuje provjeru podataka na poslužitelju.
Primjeri
<!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>Rezultat
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.