CKTIS / HTML
maxlength — comprimento máximo do texto
O atributo maxlength limita o comprimento do texto em textarea e em determinados tipos de input. Conta unidades de código UTF-16, não caracteres percecionados pelo utilizador. Não limita um valor numérico nem trunca automaticamente o texto atribuído por um script.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
maxlength="N"maxlength="N" especifica o comprimento máximo do texto. N tem de ser um número inteiro não negativo; 0 é permitido. O atributo aplica-se a textarea e aos tipos de input text, search, tel, url, email e password. Não se aplica a number: max limita um valor numérico, não o número dos seus algarismos.
O comprimento é medido em unidades de código UTF-16, não em caracteres percecionados pelo utilizador: alguns emojis ocupam duas unidades. Em textarea, cada quebra de linha normalizada conta como uma unidade.
Se o atributo for omitido, este limite não existe. Se também for especificado minlength, o respetivo valor não pode exceder maxlength. Por si só, maxlength não exige que o campo seja preenchido; para isso, use required.
O navegador pode impedir a introdução de texto demasiado longo. O estado validity.tooLong exige que o limite tenha sido excedido, que a indicação de valor alterado esteja definida e que a última alteração tenha sido feita pelo utilizador. Atribuir .value através de um script não trunca o texto nem define, por si só, este erro, como demonstra o exemplo. As restrições do lado do cliente não substituem a validação do lado do servidor.
Exemplos
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>maxlength</title>
<label for="tag">Tag (maximum 4 UTF-16 code units)</label>
<input id="tag" type="text" maxlength="4">
<pre id="result"></pre>
<script>
const tag = document.getElementById('tag');
tag.value = 'ABCDE';
document.getElementById('result').textContent =
`${tag.maxLength}\n${tag.value}\n${tag.validity.tooLong}`;
</script>
</html>Resultado
4 ABCDE 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.