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.