Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

pattern — wzorzec walidacji pola

Atrybut `pattern` określa wyrażenie regularne, do którego musi pasować cała niepusta wartość pola. W polu typu `email` z atrybutem `multiple` każdy adres musi pasować do wzorca osobno. Aby pole było obowiązkowe, użyj `required`.

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

Składnia

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

pattern dotyczy typów text, search, tel, url, email i password elementu input, nie typu number ani elementu textarea. Sprawdza format wartości, zamiast filtrować wpisywane znaki.

Wartość atrybutu to wyrażenie regularne JavaScript kompilowane z flagą v, bez ograniczników /.../. Dopasowanie obejmuje całą wartość, jak przy ^(?:pattern)$; kotwice nie są potrzebne. Nieprawidłowe wyrażenie nie ustanawia ograniczenia wzorca.

Niedopasowana niepusta wartość powoduje validity.patternMismatch. Pusta wartość nie narusza pattern; required może jednak powodować validity.valueMissing. Pusty wzorzec pattern="" odrzuca każdą niepustą wartość. Dla email z multiple wzorzec jest sprawdzany osobno dla każdego adresu; nadal obowiązują ograniczenia typu email lub url.

Opisz wymagany format użytkownikowi; title, jeśli występuje, musi opisywać wzorzec. W przykładzie [A-Z]{2}[0-9]{3} oznacza dwie wielkie litery ASCII i trzy cyfry ASCII.

Przykłady

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

Wynik

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

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła