CKTIS / JavaScript
HTMLInputElement: тип, състояние и ограничения на полето
Запознайте се с шест свойства на HTMLInputElement за избор на тип поле, прочитане на състоянието на отметката, задаване на ограничения и деактивиране на контрола. Разграничавайте текущото състояние от началните атрибути и съобщението за проверка от самия резултат от проверката.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
input.validationMessage; input.minLength = 3; input.type = "text"; input.checked = true; input.max = "10"; input.disabled = true;HTMLInputElement е DOM интерфейсът на браузъра за полета за въвеждане и не е част от самия ECMAScript. type е низ, който избира вида на контролата, например text, number или checkbox; видът определя кои други ограничения се прилагат. Тези свойства са широко достъпни в съвременните браузъри, но поддръжката на интерфейса за отделните типове полета може да се различава. Сам по себе си Node 24 не доказва поддръжка на този API.
minLength е числовото отражение на атрибута minlength: задава минималната дължина на текста в UTF-16 кодови единици, които не съвпадат непременно с възприеманите от потребителя знаци. -1 означава, че няма зададена минимална дължина. Свойството се прилага към текстови типове, без required не изисква непразна стойност, а проверката за твърде кратък текст се отнася до промени от потребителя, не само до присвояване чрез скрипт. max е низ, например "10", който задава горната граница за числа, дати или часове при съответните типове; за разлика от maxLength, не ограничава дължината на текста. При type="time" часовете се повтарят в 24-часов цикъл: ако min указва по-късен час от max, допустимият диапазон започва от min, преминава през полунощ и завършва при max. Например при min="22:00" и max="02:00" часът 23:00 е в допустимия диапазон, въпреки че е по-късен от max.
checked е булева стойност, описваща текущото състояние на отметка в поле checkbox или radio, а не текстовата му value. Атрибутът checked задава състоянието по подразбиране, отразено чрез defaultChecked; промяната на текущото състояние на отметката не актуализира този атрибут. disabled отразява булев атрибут: задаването му на true предотвратява взаимодействието, изключва контролата от изпратените данни на формуляра и от проверката на ограниченията. Не е равнозначно на readOnly.
validationMessage е низ само за четене, който съдържа локализирано съобщение за грешка или "", когато контролата спазва ограниченията или е изключена от проверката. Следователно празното съобщение не доказва, че деактивирана контрола има валидна стойност. Задайте собствено съобщение с setCustomValidity() и го изчистете с setCustomValidity(""). Примерът проверява дали съобщението е празно, вместо да сравнява текст, зависещ от езика, и не се опитва да покаже грешка minLength чрез присвояване от скрипт.
Референтни идентификатори, обхванати в тази статия: HTMLInputElement.validationMessage, HTMLInputElement.minLength, HTMLInputElement.type, HTMLInputElement.checked, HTMLInputElement.max, HTMLInputElement.disabled.
Примери
(() => {
const text = document.createElement("input");
text.type = "text";
text.minLength = 3;
console.log(text.type, text.minLength);
const box = document.createElement("input");
box.type = "checkbox";
box.checked = true;
console.log(box.checked, box.defaultChecked);
const number = document.createElement("input");
number.type = "number";
number.max = "10";
number.value = "11";
console.log(number.max, number.validity.rangeOverflow);
console.log(number.validationMessage !== "");
number.disabled = true;
console.log(number.disabled, number.willValidate);
console.log(number.validationMessage === "");
})();Резултат
text 3 true false 10 true true true false true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.
Източници
- HTMLInputElement - Web APIs | MDN
- HTMLInputElement: validationMessage property - Web APIs | MDN
- HTMLInputElement: minLength property - Web APIs | MDN
- HTMLInputElement: type property - Web APIs | MDN
- HTMLInputElement: checked property - Web APIs | MDN
- HTMLInputElement: max property - Web APIs | MDN
- HTMLInputElement: disabled property - Web APIs | MDN
- minlength HTML attribute - HTML | MDN