CKTIS / CSS
:user-invalid — neveljavna polja po interakciji
Psevdorazred :user-invalid izbere neveljavne kontrolnike obrazca šele po interakciji, ki upravičuje prikaz napake, na primer po poskusu oddaje obrazca. Tako prepreči, da bi bila nedotaknjena polja označena kot napačna takoj ob odprtju strani.
Različica: 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 psevdorazred brez argumentov. V HTML se ujema z elementi input, textarea in select, za katere velja preverjanje omejitev, teh omejitev ne izpolnjujejo in imajo notranje stanje user validity nastavljeno na true. Ime tega stanja ne pomeni, da je vrednost veljavna.
V nasprotju z :invalid upošteva zgodovino interakcij: prazno polje z atributom required je lahko ob nalaganju neveljavno, vendar se še ne ujema z :user-invalid. Poskus oddaje obrazca je pomemben trenutek za prikaz napak; ne predpostavljaj pa, da vedno zadostuje že samo pridobitev in izguba fokusa. Podrobnosti zgodnejše aktivacije so odvisne od pravil HTML in brskalnika.
Vsak element, ki se ujema z :user-invalid, se ujema tudi z :invalid. :user-valid se nanaša na veljavne vnose po ustrezni interakciji; ni preprosto zanikanje :user-invalid, saj se nedotaknjeno polje morda ne ujema z nobenim od njiju.
Primer združuje obrobo z besedilom napake, namesto da bi se zanašal samo na barvo. CSS se odziva na stanje preverjanja, vendar sam ne določa omejitev in ne nadomešča preverjanja podatkov na strežniku.
Primeri
<!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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.