Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / HTML

pattern — vzorec za preverjanje vnosa

Atribut `pattern` določa regularni izraz, s katerim se mora ujemati celotna neprazna vrednost vnosnega polja. Pri polju tipa `email` z atributom `multiple` se mora z vzorcem ujemati vsak naslov posebej. Za obvezen vnos uporabite `required`.

Različica: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaksa

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

pattern velja za tipe input text, search, tel, url, email in password, ne pa za number ali textarea. Preverja obliko vrednosti, namesto da bi filtriral vnesene znake.

Vrednost atributa je regularni izraz JavaScript, preveden z zastavico v, brez ločil /.../. Ujemanje zajema celotno vrednost, kot pri ^(?:pattern)$; izrecna sidra niso potrebna. Neveljaven izraz ne določi nobene omejitve vzorca.

Neprazna vrednost, ki se ne ujema, povzroči validity.patternMismatch. Prazna vrednost ne krši pattern, vendar lahko required povzroči validity.valueMissing. Prazen vzorec pattern="" zavrne vsako neprazno vrednost. Pri email z multiple se vzorec preveri posebej za vsak naslov; omejitve osnovnega tipa email ali url še vedno veljajo.

Uporabnikom opišite zahtevano obliko; če je naveden title, mora opisovati vzorec. V primeru [A-Z]{2}[0-9]{3} pomeni dve veliki črki ASCII, ki jima sledijo tri števke ASCII.

Primeri

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

Rezultat

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri