WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

:valid — Selektor für gültige Daten

Die CSS-Pseudoklasse `:valid` wählt Steuerelemente aus, die der Constraint-Validierung unterliegen und ihre Anforderungen erfüllen. Sie wählt auch Formulare ohne ungültige zugehörige Steuerelemente und `fieldset`-Elemente ohne ungültige Steuerelemente unter ihren Nachfahren aus. Eine vorherige Nutzerinteraktion ist nicht erforderlich.

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

Syntax

:valid

:valid ist eine Pseudoklasse ohne Argumente: Schreibe sie ohne Klammern, zum Beispiel input:valid. In HTML trifft sie auf Elemente zu, die der Constraint-Validierung unterliegen und ihre Anforderungen erfüllen, sowie unter den unten beschriebenen Bedingungen auf Formulare und fieldset-Elemente. Sie kann gültige Felder formatieren, legt selbst aber keine Validierungsregeln fest.

Das Ergebnis hängt unter anderem von required, type, pattern und einem mit setCustomValidity() festgelegten eigenen Fehler ab. Ein leeres optionales Feld mit type="email" kann gültig sein; :valid bedeutet also nicht „ausgefüllt“. Die Pseudoklasse ist auch nicht gleichbedeutend mit :not(:invalid): Auf ein Element, das nicht der Constraint-Validierung unterliegt, trifft möglicherweise keine der beiden Gültigkeitspseudoklassen zu.

form:valid trifft auf ein Formular zu, wenn keines seiner zugehörigen Steuerelemente, die der Constraint-Validierung unterliegen, gegen seine Anforderungen verstößt. Das gilt auch, wenn keines der zugehörigen Steuerelemente der Constraint-Validierung unterliegt.

fieldset:valid trifft auf ein fieldset-Element zu, wenn unter seinen Nachfahren kein Element der Constraint-Validierung unterliegt und zugleich gegen seine Anforderungen verstößt. Das fieldset-Element selbst muss dafür nicht der Constraint-Validierung unterliegen.

:valid kann bereits beim Laden der Seite gelten; :user-valid berücksichtigt zusätzlich einen Zustand im Zusammenhang mit der Nutzerinteraktion.

Im Beispiel erfüllt A12 das Muster pattern, B12 dagegen nicht. Daher trifft :valid nicht auf das gesamte Formular zu. Der Rahmen wird entsprechend dem Zustand des Feldes aktualisiert, der Diagnosetext wird jedoch nur einmal berechnet. Vermittle Gültigkeit nicht ausschließlich durch Farbe und betrachte die Browser-Validierung nicht als Ersatz für die serverseitige Validierung.

Beispiele

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>:valid example</title>
<style>
  input { border: 3px solid gray; }
  input:valid { border-color: green; }
</style>
<form id="codes">
  <label>Code A <input id="a" required pattern="A[0-9]{2}" value="A12"></label>
  <label>Code B <input id="b" required pattern="A[0-9]{2}" value="B12"></label>
</form>
<pre id="result"></pre>
<script>
  const a = document.getElementById('a');
  const b = document.getElementById('b');
  const codes = document.getElementById('codes');
  document.getElementById('result').textContent = [
    `a: ${a.matches(':valid')}`,
    `b: ${b.matches(':valid')}`,
    `codes: ${codes.matches(':valid')}`
  ].join('\n');
</script>
</html>

Ergebnis

a: true
b: false
codes: false

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