Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

:invalid — element niespełniający warunków walidacji

Pseudoklasa CSS :invalid dopasowuje elementy niespełniające warunków walidacji danych. Pozwala wyróżniać błędne wartości lub puste wymagane pola, także przed interakcją użytkownika.

Wersja: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Składnia

:invalid

:invalid to pseudoklasa, a nie informacja o błędzie składni selektora. W HTML dopasowuje kontrolki podlegające walidacji ograniczeń, które nie spełniają jej warunków. Selektor input:invalid ogranicza dopasowanie do elementów input.

Dopasowanie może wystąpić od razu: puste pole z required nie wymaga wcześniejszego wysłania formularza. :user-invalid uwzględnia dodatkowo stan walidacji związany z interakcją użytkownika; nie jest zamienną nazwą :invalid. Elementy bez semantyki walidacji nie pasują ani do :invalid, ani do :valid, więc :not(:valid) nie jest równoważne :invalid.

HTML obejmuje też kontenery: form:invalid dopasowuje formularz będący właścicielem co najmniej jednej niepoprawnej kontrolki podlegającej walidacji, a fieldset:invalid — grupę mającą takiego potomka. Nie oznacza to dopasowania dowolnego przodka błędnego pola.

Przykład sprawdza puste wymagane pole i wartość Ada, po czym przywraca pustą wartość. Oczekiwany tekst podano osobno; przykład wymaga lokalnej weryfikacji. W interfejsie nie polegaj wyłącznie na kolorze: dodaj zrozumiały komunikat o błędzie.

Przykłady

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>:invalid example</title>
<style>
  input:invalid { outline: 3px solid crimson; }
</style>
<label for="name">Name (required)</label>
<input id="name" required autocomplete="off">
<pre id="result"></pre>
<script>
  const input = document.getElementById('name');
  const results = [];
  input.value = '';
  results.push(`empty: ${input.matches(':invalid')}`);
  input.value = 'Ada';
  results.push(`filled: ${input.matches(':invalid')}`);
  input.value = '';
  document.getElementById('result').textContent = results.join('\n');
</script>
</html>

Wynik

empty: true
filled: false

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła