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
- 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