KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

pattern — validatiepatroon voor invoer

Het attribuut `pattern` definieert een reguliere expressie waarmee de volledige niet-lege invoerwaarde moet overeenkomen. Bij een invoerveld van het type `email` met `multiple` moet elk adres afzonderlijk aan het patroon voldoen. Gebruik `required` om het veld verplicht te maken.

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

Syntax

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

pattern geldt voor de input-typen text, search, tel, url, email en password, maar niet voor number of textarea. Het controleert de opmaak van de waarde en filtert geen getypte tekens.

De attribuutwaarde is een JavaScript-reguliere expressie die met de vlag v wordt gecompileerd, zonder /.../-scheidingstekens. De overeenkomst omvat de volledige waarde, zoals bij ^(?:pattern)$; expliciete ankers zijn niet nodig. Een ongeldige expressie stelt geen patroonbeperking in.

Een niet-lege waarde die niet overeenkomt, veroorzaakt validity.patternMismatch. Een lege waarde schendt pattern niet, maar required kan validity.valueMissing veroorzaken. Een leeg patroon, pattern="", wijst elke niet-lege waarde af. Bij email met multiple wordt het patroon afzonderlijk voor elk adres gecontroleerd; de beperkingen van het onderliggende type email of url blijven gelden.

Beschrijf de vereiste opmaak aan gebruikers; als title aanwezig is, moet die het patroon beschrijven. In het voorbeeld betekent [A-Z]{2}[0-9]{3} twee hoofdletters uit ASCII, gevolgd door drie ASCII-cijfers.

Voorbeelden

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()
  }));
}

Resultaat

{"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}

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen