CKTIS / HTML
maxlength — максимална дължина на текста
Атрибутът maxlength ограничава дължината на текста в textarea и избрани типове input. Брои UTF-16 кодови единици, а не възприемани от потребителя знаци. Не ограничава числова стойност и не съкращава автоматично текст, зададен от скрипт.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
maxlength="N"maxlength="N" задава максималната дължина на текста. N трябва да е неотрицателно цяло число; 0 е позволено. Атрибутът се прилага за textarea и следните типове input: text, search, tel, url, email и password. Не се прилага за number: max ограничава числова стойност, а не броя на цифрите ѝ.
Дължината се измерва в UTF-16 кодови единици, а не във възприемани от потребителя знаци: някои емоджита заемат две единици. В textarea всеки нормализиран край на ред се брои за една единица.
Ако атрибутът липсва, това ограничение не важи. Ако е зададен и minlength, стойността му не трябва да надвишава maxlength. Сам по себе си maxlength не изисква полето да е попълнено; за това се използва required.
Браузърът може да предотврати въвеждането на прекалено дълъг текст. Състоянието validity.tooLong изисква да е надвишен лимитът, флагът за променена стойност да е зададен и последната промяна да е направена от потребителя. Задаването на .value чрез скрипт не съкращава текста и само по себе си не задава тази грешка, както показва примерът. Ограниченията от страна на клиента не заменят проверката от страна на сървъра.
Примери
<!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>Резултат
4 ABCDE false
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.