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

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

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

Източници