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

CKTIS / HTML

autocapitalize: uma indicação de maiúsculas

Orienta o método de introdução sem confundir uma indicação para o teclado com validação.

Versão: HTML Living Standard

Sintaxe

<input autocapitalize="characters" pattern="[A-Z]+">

O atributo global autocapitalize sugere o uso de maiúsculas ao escrever: none e off desativam-no, sentences e on sugerem inícios de frase, enquanto words e characters dizem respeito aos inícios de palavra e a todas as letras. Um campo sem definição própria pode herdar a indicação do formulário. O método de introdução pode ignorá-la ou substituí-la; os campos de URL, e-mail e palavra-passe não a usam para impor maiúsculas.

Isto não transforma o texto guardado. Não deves presumir que a escrita num teclado físico, o conteúdo colado ou um valor atribuído por um script passam a maiúsculas. Usa pattern para uma verificação de validade adequada no navegador e valida também no servidor. Mudar entre maiúsculas e minúsculas exige ainda uma decisão explícita do produto: nomes e palavras-passe não devem ser normalizados às cegas.

O exemplo atribui texto em minúsculas a um campo que pede introdução em maiúsculas. O texto não cumpre o padrão até o script o converter deliberadamente. Isto demonstra a separação entre indicação, valor e validação; não testa a disposição nem o comportamento de um teclado real de telemóvel.

Exemplos

<!doctype html><meta charset="utf-8">
<label>Code <input id="code" autocapitalize="characters" pattern="[A-Z]+"></label>
<output id="result"></output><script>
const field = document.querySelector('#code');
field.value = 'abc';
const beforeValid = field.checkValidity();
// Explicit application logic, not an automatic effect of autocapitalize.
field.value = field.value.toUpperCase();
document.querySelector('#result').textContent = 'hint=' + field.autocapitalize + '; beforeValid=' + beforeValid + '; afterValid=' + field.checkValidity() + '; value=' + field.value;
</script>

Resultado

hint=characters; beforeValid=false; afterValid=true; value=ABC

O resultado muda porque a aplicação converte explicitamente a cadeia de caracteres, não porque o atributo a reescreve.

Fontes