CKTIS / HTML
maxlength — maksymalna długość tekstu
Atrybut maxlength ogranicza długość tekstu w textarea i wybranych typach input. Liczy jednostki kodowe UTF-16, a nie znaki widoczne dla użytkownika. Nie ogranicza wartości liczbowej i nie przycina automatycznie tekstu przypisanego przez skrypt.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
maxlength="N"maxlength="N" określa maksymalną długość tekstu. N musi być nieujemną liczbą całkowitą; 0 jest dozwolone. Atrybut dotyczy textarea oraz typów input: text, search, tel, url, email i password. Nie dotyczy number: max ogranicza wartość liczbową, a nie liczbę cyfr.
Długość jest mierzona w jednostkach kodowych UTF-16, nie w znakach postrzeganych przez użytkownika: niektóre emoji zajmują dwie jednostki. W textarea każde znormalizowane zakończenie wiersza liczy się jako jedna jednostka.
Brak atrybutu oznacza brak tego ograniczenia. Jeśli podano też minlength, jego wartość nie może przekraczać maxlength. Samo maxlength nie wymaga wypełnienia pola; do tego służy required.
Przeglądarka może zapobiegać wpisywaniu zbyt długiego tekstu. Stan validity.tooLong wymaga przekroczenia limitu, ustawionej flagi zmiany wartości oraz ostatniej zmiany wykonanej przez użytkownika. Przypisanie do .value przez skrypt nie przycina tekstu i samo nie ustawia tego błędu, co pokazuje przykład. Ograniczenie po stronie klienta nie zastępuje walidacji na serwerze.
Przykłady
<!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>Wynik
4 ABCDE false
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.