Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

maxlength — lunghezza massima del testo

L’attributo maxlength limita la lunghezza del testo in textarea e in alcuni tipi di input. Conta le unità di codice UTF-16, non i caratteri percepiti dall’utente. Non limita un valore numerico e non tronca automaticamente il testo assegnato da uno script.

Versione: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintassi

maxlength="N"

maxlength="N" specifica la lunghezza massima del testo. N deve essere un numero intero non negativo; 0 è consentito. L’attributo si applica a textarea e ai tipi di input text, search, tel, url, email e password. Non si applica a number: max limita un valore numerico, non il numero delle sue cifre.

La lunghezza è misurata in unità di codice UTF-16, non in caratteri percepiti dall’utente: alcune emoji occupano due unità. In textarea, ogni interruzione di riga normalizzata conta come un’unità.

Se l’attributo è omesso, questo limite non è presente. Se è specificato anche minlength, il suo valore non deve superare maxlength. maxlength da solo non richiede che il campo sia compilato; per questo si usa required.

Il browser può impedire l’inserimento di testo troppo lungo. Lo stato validity.tooLong richiede che il limite sia stato superato, che il flag del valore modificato sia impostato e che l’ultima modifica sia stata effettuata dall’utente. Assegnare .value tramite uno script non tronca il testo e non imposta da sé questo errore, come mostra l’esempio. I vincoli lato client non sostituiscono la convalida lato server.

Esempi

<!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>

Risultato

4
ABCDE
false

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.

Fonti