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.