WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

:in-range — ein Wert innerhalb der zulässigen Grenzen

Die Pseudoklasse :in-range wählt Steuerelemente mit Bereichsbeschränkungen aus, die weder die Unter- noch die Obergrenze verletzen. Das bedeutet jedoch nicht, dass das Feld alle Gültigkeitsbedingungen erfüllt.

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

Syntax

input:in-range { /* declarations */ }

:in-range ist eine Pseudoklasse ohne Argumente. In HTML trifft sie auf Elemente zu, die für die Constraint-Validierung infrage kommen, Bereichsbeschränkungen haben und weder einen zu kleinen noch einen zu großen Wert aufweisen. Ob ein Element übereinstimmt, ändert sich mit dem Wert des Steuerelements.

Ein typisches Beispiel ist ein input mit type="number" und min oder max. Ein gewöhnlicher Bereich von min="1" bis max="10" schließt sowohl 1 als auch 10 ein. :out-of-range kennzeichnet eine Verletzung der Grenzen. Ein Element ohne Bereichsbeschränkungen trifft auf keine der beiden Pseudoklassen zu; :not(:out-of-range) ist daher kein Ersatz für :in-range.

Verwechsle :in-range nicht mit :valid: Werden die Grenzen eingehalten, ist damit nicht sichergestellt, dass auch andere Bedingungen erfüllt sind. Ein leeres Pflichtfeld für eine Zahl kann sowohl auf :in-range als auch auf :invalid zutreffen. Ebenso kann ein Wert innerhalb der Grenzen liegen und trotzdem gegen step verstoßen.

Das Beispiel zeigt den Anfangszustand für den Wert 5. Der Rahmen kennzeichnet den Bereichsstatus, während der Text das Ergebnis der Übereinstimmung sichtbar macht, ohne sich allein auf Farbe zu stützen.

Beispiele

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>:in-range</title>
<style>
  input:in-range { border: 3px solid green; }
  input:out-of-range { border: 3px dashed crimson; }
</style>
<label>Value (1–10): <input id="value" type="number" min="1" max="10" value="5"></label>
<pre id="result"></pre>
<script>
  const input = document.querySelector('#value');
  const result = document.querySelector('#result');
  function update() {
    result.textContent = ':in-range = ' + input.matches(':in-range');
  }
  input.addEventListener('input', update);
  update();
</script>
</html>

Ergebnis

:in-range = true

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