База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / HTML

pattern — шаблон за проверка на входа

Атрибутът `pattern` задава регулярен израз, на който трябва да съответства цялата непразна стойност на полето. В поле от тип `email` с атрибут `multiple` всеки адрес трябва да съответства на шаблона поотделно. За задължително поле използвайте `required`.

Версия: WHATWG HTML Living Standard; index snapshot date recorded separately

Синтаксис

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

pattern се прилага за типовете input text, search, tel, url, email и password, но не и за number или textarea. Проверява формата на стойността, вместо да филтрира въвежданите знаци.

Стойността на атрибута е регулярен израз на JavaScript, компилиран с флага v, без разделители /.../. Съвпадението обхваща цялата стойност, както при ^(?:pattern)$; изрични котви не са нужни. Невалиден израз не задава ограничение за шаблон.

Непразна стойност, която не съвпада, води до validity.patternMismatch. Празната стойност не нарушава pattern, но required може да доведе до validity.valueMissing. Празен шаблон, pattern="", отхвърля всяка непразна стойност. При email с multiple шаблонът се проверява отделно за всеки адрес; ограниченията на основния тип email или url продължават да важат.

Опишете на потребителите необходимия формат; ако е зададен title, той трябва да описва шаблона. В примера [A-Z]{2}[0-9]{3} означава две главни ASCII букви, последвани от три ASCII цифри.

Примери

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

Резултат

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници