CKTIS / CSS
:valid — selektor poprawności danych
Pseudoklasa CSS `:valid` wybiera kontrolki podlegające walidacji ograniczeń, które spełniają swoje wymagania. Wybiera też formularze bez niepoprawnych powiązanych kontrolek oraz elementy `fieldset` bez niepoprawnych kontrolek wśród swoich potomków. Nie wymaga wcześniejszej interakcji użytkownika.
Wersja: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Składnia
:valid:valid to pseudoklasa bez argumentów: zapisuj ją bez nawiasów, na przykład input:valid. W HTML pasuje do elementów podlegających walidacji ograniczeń, które spełniają swoje wymagania, a także do formularzy i elementów fieldset na zasadach opisanych poniżej. Może służyć do stylizowania poprawnych pól, ale sama nie ustanawia reguł walidacji.
O wyniku decydują między innymi required, type, pattern oraz własny błąd ustawiony przez setCustomValidity(). Puste opcjonalne pole type="email" może być poprawne; :valid nie oznacza więc „wypełnione”. Nie jest też równoważne :not(:invalid): element niepodlegający walidacji może nie pasować do żadnej z tych dwóch pseudoklas poprawności.
form:valid pasuje do formularza, jeśli żadna z powiązanych z nim kontrolek podlegających walidacji nie narusza ograniczeń. Pasuje również wtedy, gdy żadna z powiązanych kontrolek nie podlega walidacji.
fieldset:valid pasuje do elementu fieldset, jeśli wśród jego potomków nie ma elementu, który podlega walidacji ograniczeń i ich nie spełnia. Sam fieldset nie musi podlegać walidacji, aby pasować.
:valid może działać już po załadowaniu strony; :user-valid dodatkowo uwzględnia stan związany z interakcją użytkownika.
W przykładzie A12 spełnia pattern, a B12 nie, więc cały formularz nie pasuje do :valid. Ramka aktualizuje się wraz ze stanem pola, ale tekst diagnostyczny jest obliczany tylko raz. Nie sygnalizuj poprawności wyłącznie kolorem i nie traktuj walidacji w przeglądarce jako zamiennika walidacji po stronie serwera.
Przykłady
<!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>Wynik
a: true b: false codes: false
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.