CKTIS / HTML
pattern — ověřovací vzor vstupního pole
Atribut `pattern` určuje regulární výraz, kterému musí odpovídat celá neprázdná hodnota pole. U pole typu `email` s atributem `multiple` musí vzoru odpovídat každá adresa zvlášť. Povinné zadání hodnoty zajistí atribut `required`.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<input type="text" pattern="[A-Z]{2}[0-9]{3}">pattern se vztahuje na typy input text, search, tel, url, email a password, nikoli na number nebo textarea. Ověřuje formát hodnoty, místo aby filtroval zadávané znaky.
Hodnota atributu je regulární výraz JavaScriptu kompilovaný s příznakem v, bez oddělovačů /.../. Shoda se posuzuje pro celou hodnotu, jako u ^(?:pattern)$; explicitní kotvy nejsou potřeba. Neplatný výraz žádné omezení vzoru nenastaví.
Neprázdná hodnota, která vzoru neodpovídá, způsobí validity.patternMismatch. Prázdná hodnota neporušuje pattern, ale required může způsobit validity.valueMissing. Prázdný vzor pattern="" odmítne každou neprázdnou hodnotu. U email s multiple se vzor kontroluje zvlášť pro každou adresu; omezení příslušného typu email nebo url se uplatňují dál.
Popište uživatelům požadovaný formát; pokud je uvedeno title, musí vzor popisovat. V příkladu [A-Z]{2}[0-9]{3} znamená dvě velká písmena ASCII následovaná třemi číslicemi ASCII.
Příklady
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()
}));
}Výsledek
{"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}Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.