Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

:out-of-range — wartość poza zakresem

Pseudoklasa `:out-of-range` wybiera kontrolki formularza, których wartość jest poniżej dolnej lub powyżej górnej granicy dozwolonego zakresu. W HTML dotyczy elementów podlegających walidacji ograniczeń i mających ograniczenia zakresu; nie oznacza każdego rodzaju niepoprawnej wartości.

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

Składnia

:out-of-range

:out-of-range to pseudoklasa stanu kontrolki, a nie pseudoelement. Zapis input:out-of-range wybiera pasujące elementy input. W HTML element musi podlegać walidacji ograniczeń, mieć ograniczenia zakresu i wykazywać niedomiar albo nadmiar wartości.

Dla input typu number atrybuty min i max wyznaczają odpowiednio dolną i górną granicę. Przy min="1" i max="10" wartości 0 i 11 są poza zakresem, natomiast 1 i 10 nie są. Dopasowanie aktualizuje się wraz ze zmianą wartości; nie wymaga wysłania formularza.

Nie utożsamiaj :out-of-range z :invalid: brak wymaganej wartości lub niedopasowanie do step to inne naruszenia. Element bez ograniczeń zakresu nie pasuje ani do :out-of-range, ani do :in-range, więc :not(:out-of-range) nie jest odpowiednikiem :in-range. Kontrolki wyłączone lub tylko do odczytu, wyłączone z walidacji ograniczeń, również nie pasują.

Przykład wyróżnia dwie wartości poza zakresem i wypisuje ich identyfikatory. Style reagują na edycję, ale tekst wyniku jest jednorazowym odczytem początkowego stanu.

Przykłady

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>:out-of-range</title>
<style>
  input:out-of-range {
    outline: 3px solid #b00020;
    background: #fff0f0;
  }
</style>
<label>Below minimum <input id="low" type="number" min="1" max="10" value="0"></label>
<label>Within limits <input id="middle" type="number" min="1" max="10" value="5"></label>
<label>Above maximum <input id="high" type="number" min="1" max="10" value="11"></label>
<pre id="result"></pre>
<script>
  const matches = document.querySelectorAll('input:out-of-range');
  document.getElementById('result').textContent =
    Array.from(matches, input => input.id).join(', ');
</script>
</html>

Wynik

low, high

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

Źródła