WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

pattern — Validierungsmuster für Eingabefelder

Das Attribut `pattern` legt einen regulären Ausdruck fest, auf den der gesamte nicht leere Eingabewert passen muss. Bei einem Feld vom Typ `email` mit `multiple` muss jede Adresse einzeln zum Muster passen. Mit `required` machen Sie das Feld zum Pflichtfeld.

Version: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

<input type="text" pattern="[A-Z]{2}[0-9]{3}">

pattern gilt für input-Typen text, search, tel, url, email und password, nicht für number oder textarea. Es prüft das Format des Werts, statt eingegebene Zeichen zu filtern.

Der Attributwert ist ein JavaScript-regulärer Ausdruck, der mit dem Flag v und ohne /.../-Begrenzer kompiliert wird. Der Abgleich umfasst den gesamten Wert, wie bei ^(?:pattern)$; explizite Anker sind nicht nötig. Ein ungültiger Ausdruck legt keine Musterbedingung fest.

Ein nicht leerer Wert, der nicht zum Muster passt, führt zu validity.patternMismatch. Ein leerer Wert verletzt pattern nicht, aber required kann validity.valueMissing verursachen. Ein leeres Muster, pattern="", weist jeden nicht leeren Wert zurück. Bei email mit multiple wird das Muster für jede Adresse einzeln geprüft; die Einschränkungen des zugrunde liegenden Typs email oder url gelten weiterhin.

Beschreiben Sie den Nutzenden das erforderliche Format; falls title vorhanden ist, muss es das Muster beschreiben. Im Beispiel bedeutet [A-Z]{2}[0-9]{3} zwei große ASCII-Buchstaben gefolgt von drei ASCII-Ziffern.

Beispiele

const input = document.createElement('input');
input.type = 'text';
input.pattern = '[A-Z]{2}[0-9]{3}';
input.required = true;

for (const value of ['AB123', 'ab123', 'XAB123', '']) {
  input.value = value;
  console.log(JSON.stringify({
    value,
    patternMismatch: input.validity.patternMismatch,
    valueMissing: input.validity.valueMissing,
    valid: input.checkValidity()
  }));
}

Ergebnis

{"value":"AB123","patternMismatch":false,"valueMissing":false,"valid":true}
{"value":"ab123","patternMismatch":true,"valueMissing":false,"valid":false}
{"value":"XAB123","patternMismatch":true,"valueMissing":false,"valid":false}
{"value":"","patternMismatch":false,"valueMissing":true,"valid":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