CKTIS / HTML
pattern — schema di convalida dell’input
L’attributo `pattern` definisce un’espressione regolare a cui deve corrispondere l’intero valore non vuoto del campo. In un campo di tipo `email` con `multiple`, ogni indirizzo deve corrispondere allo schema separatamente. Usa `required` per rendere il campo obbligatorio.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
<input type="text" pattern="[A-Z]{2}[0-9]{3}">pattern si applica ai tipi input text, search, tel, url, email e password, non a number né a textarea. Controlla il formato del valore invece di filtrare i caratteri digitati.
Il valore dell’attributo è un’espressione regolare JavaScript compilata con il flag v, senza delimitatori /.../. La corrispondenza riguarda l’intero valore, come con ^(?:pattern)$; non servono ancore esplicite. Un’espressione non valida non imposta alcun vincolo di schema.
Un valore non vuoto che non corrisponde causa validity.patternMismatch. Un valore vuoto non viola pattern, ma required può causare validity.valueMissing. Uno schema vuoto, pattern="", rifiuta ogni valore non vuoto. Per email con multiple, lo schema viene verificato separatamente per ogni indirizzo; restano valide le limitazioni del tipo sottostante email o url.
Descrivi agli utenti il formato richiesto; se presente, title deve descrivere lo schema. Nell’esempio, [A-Z]{2}[0-9]{3} indica due lettere ASCII maiuscole seguite da tre cifre ASCII.
Esempi
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()
}));
}Risultato
{"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}Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.