WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

:out-of-range — ein Wert außerhalb des zulässigen Bereichs

Die Pseudoklasse `:out-of-range` wählt Formularsteuerelemente aus, deren Wert unter der Untergrenze oder über der Obergrenze des zulässigen Bereichs liegt. In HTML gilt sie für Elemente, die an der Constraint-Validierung teilnehmen und Bereichsgrenzen haben; sie steht nicht für jede Art ungültigen Werts.

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

Syntax

:out-of-range

:out-of-range ist eine Pseudoklasse für den Zustand eines Steuerelements, kein Pseudoelement. Der Selektor input:out-of-range wählt passende input-Elemente aus. In HTML muss ein Element für die Constraint-Validierung infrage kommen, Bereichsgrenzen haben und eine Bereichsunterschreitung oder -überschreitung aufweisen.

Bei einem input des Typs number legen min und max die Unter- beziehungsweise Obergrenze fest. Mit min="1" und max="10" liegen die Werte 0 und 11 außerhalb des Bereichs, 1 und 10 dagegen nicht. Die Übereinstimmung wird aktualisiert, wenn sich der Wert ändert; ein Absenden des Formulars ist nicht erforderlich.

Setze :out-of-range nicht mit :invalid gleich: Ein fehlender Pflichtwert oder eine Abweichung von step ist ein anderer Verstoß. Ein Element ohne Bereichsgrenzen passt weder auf :out-of-range noch auf :in-range; daher ist :not(:out-of-range) nicht gleichbedeutend mit :in-range. Deaktivierte oder schreibgeschützte Steuerelemente, die von der Constraint-Validierung ausgeschlossen sind, passen ebenfalls nicht.

Das Beispiel hebt zwei Werte außerhalb des Bereichs hervor und gibt ihre IDs aus. Die Formatierung reagiert auf Änderungen, der Ergebnistext ist jedoch eine einmalige Momentaufnahme des Anfangszustands.

Beispiele

<!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>

Ergebnis

low, high

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen