CKTIS / CSS
:valid — izbirnik veljavnosti podatkov
Psevdorazred CSS `:valid` izbere kontrolnike, za katere velja preverjanje omejitev in ki te omejitve izpolnjujejo. Izbere tudi obrazce brez neveljavnih povezanih kontrolnikov in elemente `fieldset`, ki med potomci nimajo neveljavnih kontrolnikov. Predhodna interakcija uporabnika ni potrebna.
Različica: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintaksa
:valid:valid je psevdorazred brez argumentov: zapišemo ga brez oklepajev, na primer input:valid. V HTML se ujema z elementi, za katere velja preverjanje omejitev in ki te omejitve izpolnjujejo, pod spodaj opisanimi pogoji pa tudi z obrazci in elementi fieldset. Z njim lahko oblikujemo veljavna polja, vendar sam ne določa pravil preverjanja.
Rezultat je med drugim odvisen od atributov required, type, pattern in lastne napake, nastavljene z setCustomValidity(). Prazno neobvezno polje z type="email" je lahko veljavno, zato :valid ne pomeni »izpolnjeno«. Prav tako ni enakovreden :not(:invalid): element, za katerega preverjanje omejitev ne velja, se morda ne ujema z nobenim od teh dveh psevdorazredov veljavnosti.
form:valid se ujema z obrazcem, če nobeden od njegovih povezanih kontrolnikov, za katere velja preverjanje omejitev, teh omejitev ne krši. To velja tudi za obrazce brez povezanih kontrolnikov, za katere velja to preverjanje.
fieldset:valid se ujema z elementom fieldset, če nobeden od njegovih potomcev, za katere velja preverjanje omejitev, teh omejitev ne krši. Za sam element fieldset to preverjanje ni pogoj za ujemanje.
:valid lahko velja že ob nalaganju strani; :user-valid poleg tega upošteva stanje, povezano z interakcijo uporabnika.
V primeru A12 izpolnjuje pattern, B12 pa ne, zato se celoten obrazec ne ujema z :valid. Obroba se posodablja glede na stanje polja, diagnostično besedilo pa se izračuna samo enkrat. Veljavnosti ne sporočajte samo z barvo in preverjanja v brskalniku ne obravnavajte kot nadomestilo za preverjanje na strežniku.
Primeri
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>:valid example</title>
<style>
input { border: 3px solid gray; }
input:valid { border-color: green; }
</style>
<form id="codes">
<label>Code A <input id="a" required pattern="A[0-9]{2}" value="A12"></label>
<label>Code B <input id="b" required pattern="A[0-9]{2}" value="B12"></label>
</form>
<pre id="result"></pre>
<script>
const a = document.getElementById('a');
const b = document.getElementById('b');
const codes = document.getElementById('codes');
document.getElementById('result').textContent = [
`a: ${a.matches(':valid')}`,
`b: ${b.matches(':valid')}`,
`codes: ${codes.matches(':valid')}`
].join('\n');
</script>
</html>Rezultat
a: true b: false codes: false
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.