Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

HTMLInputElement: typ, stan i ograniczenia pola

Poznaj sześć właściwości HTMLInputElement służących do ustawiania typu pola, odczytu zaznaczenia, określania ograniczeń oraz wyłączania kontrolki. Odróżniaj bieżący stan od atrybutów początkowych i komunikat walidacji od samego wyniku sprawdzania.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

input.validationMessage; input.minLength = 3; input.type = "text"; input.checked = true; input.max = "10"; input.disabled = true;

HTMLInputElement to przeglądarkowy interfejs DOM pól formularza, a nie część samego ECMAScript. type jest ciągiem określającym rodzaj pola, np. text, number lub checkbox; rodzaj decyduje o zastosowaniu pozostałych ograniczeń. Te właściwości są szeroko dostępne w nowoczesnych przeglądarkach, ale obsługa interfejsu konkretnego typu pola może się różnić. Node 24 sam w sobie nie potwierdza obsługi tego API.

minLength to liczbowy odpowiednik atrybutu minlength: określa minimalną długość tekstu w jednostkach kodowych UTF-16, niekoniecznie w znakach widocznych dla użytkownika. Wartość -1 oznacza brak minimum. Dotyczy typów tekstowych, nie wymusza niepustej wartości bez required, a sprawdzanie zbyt krótkiego tekstu dotyczy zmian użytkownika, nie samego przypisania przez skrypt. max jest ciągiem, np. "10", który określa górną granicę wartości liczbowej, daty lub czasu dla odpowiednich typów; nie ogranicza długości tekstu jak maxLength. W przypadku type="time" godziny tworzą cykl dobowy: gdy min wskazuje późniejszą godzinę niż max, dozwolony zakres biegnie od min przez północ do max. Na przykład przy min="22:00" i max="02:00" godzina 23:00 mieści się w zakresie, choć jest późniejsza niż max.

checked jest wartością logiczną opisującą bieżące zaznaczenie checkbox lub radio, a nie ich tekstową value. Atrybut checked określa stan domyślny, odzwierciedlany przez defaultChecked; zmiana bieżącego zaznaczenia nie aktualizuje tego atrybutu. disabled odzwierciedla atrybut logiczny: ustawienie true wyłącza interakcję, wyklucza pole z wysyłanych danych formularza i z walidacji ograniczeń. Nie jest odpowiednikiem readOnly.

validationMessage jest ciągiem tylko do odczytu: zawiera lokalizowany komunikat błędu albo "", gdy pole spełnia ograniczenia lub nie podlega walidacji. Pusty komunikat nie dowodzi więc, że wyłączone pole ma poprawną wartość. Własny komunikat ustawia się przez setCustomValidity(), a usuwa przez setCustomValidity(""). Przykład porównuje pustkę komunikatu zamiast zależnego od języka brzmienia i nie próbuje wykazywać błędu minLength przez przypisanie skryptowe.

Identyfikatory objęte tym wpisem: HTMLInputElement.validationMessage, HTMLInputElement.minLength, HTMLInputElement.type, HTMLInputElement.checked, HTMLInputElement.max, HTMLInputElement.disabled.

Przykłady

(() => {
  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 === "");
})();

Wynik

text 3
true false
10 true
true
true false
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła