CKTIS / HTML
maxlength — maximálna dĺžka textu
Atribút maxlength obmedzuje dĺžku textu v textarea a vybraných typoch input. Počíta jednotky kódu UTF-16, nie znaky vnímané používateľom. Neobmedzuje číselnú hodnotu ani automaticky neskracuje text priradený skriptom.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
maxlength="N"maxlength="N" určuje maximálnu dĺžku textu. N musí byť nezáporné celé číslo; 0 je povolené. Atribút sa vzťahuje na textarea a tieto typy input: text, search, tel, url, email a password. Na number sa nevzťahuje: max obmedzuje číselnú hodnotu, nie počet jej číslic.
Dĺžka sa meria v jednotkách kódu UTF-16, nie v znakoch vnímaných používateľom: niektoré emoji zaberajú dve jednotky. V textarea sa každý normalizovaný koniec riadka počíta ako jedna jednotka.
Ak atribút chýba, toto obmedzenie sa neuplatňuje. Ak je zadané aj minlength, jeho hodnota nesmie prekročiť maxlength. Samotné maxlength nevyžaduje vyplnenie poľa; na to slúži required.
Prehliadač môže zabrániť zadaniu príliš dlhého textu. Stav validity.tooLong vyžaduje prekročenie limitu, nastavený príznak zmenenej hodnoty a poslednú zmenu vykonanú používateľom. Priradenie .value skriptom text neskráti a samo túto chybu nenastaví, ako ukazuje príklad. Obmedzenia na strane klienta nenahrádzajú overovanie na strane servera.
Prí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ýsledok
4 ABCDE false
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.