Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

pattern — padrão de validação de um campo de entrada

O atributo `pattern` define uma expressão regular à qual tem de corresponder todo o valor não vazio do campo. Num campo do tipo `email` com `multiple`, cada endereço tem de corresponder ao padrão separadamente. Use `required` para tornar o campo obrigatório.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

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

pattern aplica-se aos tipos input text, search, tel, url, email e password, mas não a number nem a textarea. Verifica o formato do valor em vez de filtrar os caracteres introduzidos.

O valor do atributo é uma expressão regular JavaScript compilada com a flag v, sem delimitadores /.../. A correspondência abrange o valor completo, como em ^(?:pattern)$; não são necessárias âncoras explícitas. Uma expressão inválida não estabelece qualquer restrição de padrão.

Um valor não vazio que não corresponda provoca validity.patternMismatch. Um valor vazio não viola pattern, embora required possa provocar validity.valueMissing. Um padrão vazio, pattern="", rejeita todos os valores não vazios. Para email com multiple, o padrão é verificado separadamente para cada endereço; as restrições do tipo subjacente email ou url continuam a aplicar-se.

Descreva aos utilizadores o formato exigido; se existir, title tem de descrever o padrão. No exemplo, [A-Z]{2}[0-9]{3} significa duas letras maiúsculas ASCII seguidas de três algarismos ASCII.

Exemplos

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

Resultado

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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes