База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници