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

CKTIS / HTML

minlength — comprimento mínimo do texto

O atributo minlength define o comprimento mínimo de um valor não vazio introduzido pelo utilizador num textarea ou num campo input compatível. Não torna o campo obrigatório; para isso, use required.

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

Sintaxe

minlength="N"

minlength="N" define um comprimento mínimo para textarea e para input do tipo text, search, tel, url, email ou password. Não se aplica a input do tipo number: min limita o valor numérico, não o comprimento do texto.

N tem de ser um número inteiro não negativo. Se também for indicado maxlength, o mínimo não pode exceder o máximo. O comprimento é medido em unidades de código UTF-16, não em caracteres visíveis. Num textarea, uma mudança de linha normalizada conta como uma unidade.

minlength não substitui required: um valor vazio não viola o mínimo. Um valor não vazio demasiado curto após uma edição do utilizador faz com que validity.tooShort === true. Atribuir apenas um valor a value em JavaScript não desencadeia esta violação; não equivale a escrever.

O exemplo apresenta o estado através de validity.tooShort e checkValidity(). Escreva abc, acrescente d e, em seguida, limpe o campo. Outras restrições, como a validade de um endereço em type="email", continuam a aplicar-se independentemente.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>minlength</title>
<label for="code">Code (min. 4)</label>
<input id="code" type="text" minlength="4">
<pre id="result">tooShort=false; valid=true</pre>
<script>
  const field = document.getElementById('code');
  const result = document.getElementById('result');
  field.addEventListener('input', () => {
    result.textContent = `tooShort=${field.validity.tooShort}; valid=${field.checkValidity()}`;
  });
</script>

Resultado

Initial: tooShort=false; valid=true
Type abc: tooShort=true; valid=false
Append d: tooShort=false; valid=true
Clear: tooShort=false; valid=true

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