CKTIS / CSS
:valid — selektor platnosti dat
Pseudotřída CSS `:valid` vybírá ovládací prvky, na které se vztahuje ověřování omezení a které tato omezení splňují. Vybírá také formuláře bez neplatných přidružených ovládacích prvků a prvky `fieldset`, které mezi svými potomky nemají neplatný ovládací prvek. Nevyžaduje předchozí interakci uživatele.
Verze: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntaxe
:valid:valid je pseudotřída bez argumentů: zapisuje se bez závorek, například input:valid. V HTML odpovídá prvkům, na které se vztahuje ověřování omezení a které tato omezení splňují, a za níže popsaných podmínek také formulářům a prvkům fieldset. Lze ji použít ke stylování platných polí, sama však žádná pravidla ověřování nestanovuje.
Výsledek závisí mimo jiné na atributech required, type, pattern a na vlastní chybě nastavené pomocí setCustomValidity(). Prázdné nepovinné pole s type="email" může být platné, takže :valid neznamená „vyplněné“. Nejde ani o totéž co :not(:invalid): prvek, na který se ověřování omezení nevztahuje, nemusí odpovídat ani jedné z těchto pseudotříd platnosti.
form:valid odpovídá formuláři, pokud žádný z jeho přidružených ovládacích prvků podléhajících ověřování omezení tato omezení neporušuje. Platí to i pro formuláře bez přidružených ovládacích prvků podléhajících tomuto ověřování.
fieldset:valid odpovídá prvku fieldset, pokud žádný z jeho potomků podléhajících ověřování omezení tato omezení neporušuje. Samotný prvek fieldset tomuto ověřování podléhat nemusí.
:valid se může uplatnit hned po načtení stránky; :user-valid navíc zohledňuje stav související s interakcí uživatele.
V příkladu A12 splňuje pattern, ale B12 nikoli, takže celý formulář neodpovídá :valid. Ohraničení se aktualizuje podle stavu pole, diagnostický text se však vypočítá pouze jednou. Nesdělujte platnost pouze barvou a nepovažujte ověřování v prohlížeči za náhradu ověřování na straně serveru.
Příklady
<!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>Výsledek
a: true b: false codes: false
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.