pattern: attributo HTML
L'attributo pattern
specifica un'espressione regolare a cui deve corrispondere il valore
del
controllo modulo. Se un valore non-null non è conforme ai vincoli impostati dal valore di
pattern, la
proprietà ValidityState
di sola lettura dell'oggetto patternMismatchs
arà true
.
L'attributo pattern
è un attributo dei tipi di input
<input type="text">
,
<input type="tel">
,
<input type="email">
,
<input type="url">
,
<input type="password">
e <input type="search">
.
L'attributo pattern
, quando specificato, è un'espressione regolare a cui il valore
dell'input deve
corrispondere affinché il valore superi la convalida del vincolo. Deve essere un'espressione
regolare JavaScript valida, come utilizzata dal tipo RegExp e come documentato nella nostra
guida
sulle espressioni regolari; il flag 'u' viene specificato durante la compilazione
dell'espressione regolare, in modo che il modello venga trattato come una sequenza di punti di
codice Unicode, anziché come ASCII. Nessuna barra in avanti deve essere specificata attorno al
testo del modello.
Se il modello specificato non è specificato o non è valido, non viene applicata alcuna espressione regolare e questo attributo viene ignorato.
Alcuni dei tipi di input che supportano l'attributo pattern
, in particolare i tipi di
input di posta
elettronica e URL , hanno sintassi dei valori previsti che devono essere abbinati. Se
l'attributo pattern
non è presente e il valore non corrisponde alla sintassi
prevista per quel
tipo di valore, la proprietà ValidityState
di sola lettura dell'oggetto
typeMismatch
sarà true
.
Usabilità
Quando si include un pattern, fornire una descrizione del modello nel testo visibile vicino al
controllo. Inoltre, includi un attributo title
che
fornisca una descrizione del
modello. I
programmi utente possono utilizzare il contenuto del titolo durante la convalida del vincolo per
dire all'utente che il modello non corrisponde. Alcuni browser mostrano una descrizione comando
con il contenuto del titolo, migliorando l'usabilità per gli utenti vedenti. Inoltre, la
tecnologia assistiva può leggere il titolo ad alta voce quando il controllo si concentra, ma non
dovrebbe essere fatto affidamento su questo per l'accessibilità.
Convalida dei vincoli
Se il valore dell'input non è la stringa vuota e il valore non corrisponde all'intera espressione
regolare, è presente una violazione del vincolo segnalata dalla proprietà
ValidityState
dell'oggetto patternMismatch
essendo true
.
L'espressione regolare del pattern,
quando confrontata con il valore, deve avere il suo inizio ancorato all'inizio della stringa e
la sua fine ancorata alla fine della stringa, che è leggermente diversa dalle espressioni
regolari JavaScript: nel caso dell'attributo pattern, stiamo confrontando l'intero valore,
non solo a qualsiasi sottoinsieme.
Liste utili
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/pattern