Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła