CKTIS / HTML
minlength — lunghezza minima del testo
L’attributo minlength imposta la lunghezza minima di un valore non vuoto inserito dall’utente in un textarea o in un campo input supportato. Non rende obbligatorio il campo; per quello si usa required.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
minlength="N"minlength="N" imposta una lunghezza minima per textarea e per input di tipo text, search, tel, url, email o password. Non si applica a input di tipo number: min limita il valore numerico, non la lunghezza del testo.
N deve essere un intero non negativo. Se viene specificato anche maxlength, il minimo non deve superare il massimo. La lunghezza viene misurata in unità di codice UTF-16, non in caratteri visibili. In textarea, un'interruzione di riga normalizzata conta come un'unità.
minlength non sostituisce required: un valore vuoto non viola il minimo. Un valore non vuoto troppo corto dopo una modifica dell’utente causa validity.tooShort === true. La sola assegnazione a value in JavaScript non attiva questa violazione e non equivale alla digitazione.
L’esempio mostra lo stato tramite validity.tooShort e checkValidity(). Digita abc, aggiungi d e poi svuota il campo. Altri vincoli, come la validità di un indirizzo con type="email", continuano ad applicarsi indipendentemente.
Esempi
<!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>Risultato
Initial: tooShort=false; valid=true Type abc: tooShort=true; valid=false Append d: tooShort=false; valid=true Clear: tooShort=false; valid=true
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.