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.