CKTIS / HTML
maxlength — maximální délka textu
Atribut maxlength omezuje délku textu v textarea a vybraných typech input. Počítá jednotky kódu UTF-16, nikoli znaky vnímané uživatelem. Neomezuje číselnou hodnotu ani automaticky nezkracuje text přiřazený skriptem.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
maxlength="N"maxlength="N" určuje maximální délku textu. N musí být nezáporné celé číslo; 0 je povoleno. Atribut se vztahuje na textarea a tyto typy input: text, search, tel, url, email a password. Na number se nevztahuje: max omezuje číselnou hodnotu, nikoli počet jejích číslic.
Délka se měří v jednotkách kódu UTF-16, nikoli ve znacích vnímaných uživatelem: některé emoji zabírají dvě jednotky. V textarea se každý normalizovaný konec řádku počítá jako jedna jednotka.
Pokud atribut chybí, toto omezení se neuplatní. Je-li zadáno také minlength, jeho hodnota nesmí překročit maxlength. Samotné maxlength nevyžaduje vyplnění pole; k tomu slouží required.
Prohlížeč může zabránit zadání příliš dlouhého textu. Stav validity.tooLong vyžaduje překročení limitu, nastavený příznak změněné hodnoty a poslední změnu provedenou uživatelem. Přiřazení .value skriptem text nezkrátí a samo tuto chybu nenastaví, jak ukazuje příklad. Omezení na straně klienta nenahrazují ověřování na straně serveru.
Příklady
<!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>Výsledek
4 ABCDE false
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.