CKTIS / JavaScript
HTMLInputElement: typ, stav a omezení vstupního pole
Seznamte se se šesti vlastnostmi HTMLInputElement pro výběr typu pole, zjištění stavu zaškrtnutí, nastavení omezení a zakázání ovládacího prvku. Rozlišujte aktuální stav od výchozích atributů a validační zprávu od samotného výsledku validace.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
input.validationMessage; input.minLength = 3; input.type = "text"; input.checked = true; input.max = "10"; input.disabled = true;HTMLInputElement je rozhraní DOM prohlížeče pro vstupní prvky, nikoli součást samotného ECMAScriptu. type je řetězec vybírající typ ovládacího prvku, například text, number nebo checkbox; typ určuje, která další omezení se uplatní. Tyto vlastnosti jsou v moderních prohlížečích široce dostupné, ale podpora rozhraní pro jednotlivé typy polí se může lišit. Samotný Node 24 nepotvrzuje podporu tohoto API.
minLength je číselným odrazem atributu minlength: nastavuje minimální délku textu v jednotkách kódu UTF-16, které nemusejí odpovídat znakům vnímaným uživatelem. Hodnota -1 znamená, že není určena žádná minimální délka. Vlastnost se vztahuje na textové typy, bez required nevyžaduje neprázdnou hodnotu a validace příliš krátkého textu se týká změn provedených uživatelem, nikoli pouhého přiřazení ze skriptu. max je řetězec, například "10", který pro příslušné typy nastavuje horní mez číselné hodnoty, data nebo času; na rozdíl od maxLength neomezuje délku textu. U type="time" se časy opakují ve 24hodinovém cyklu: pokud min označuje pozdější čas než max, povolený rozsah vede od min přes půlnoc do max. Například při min="22:00" a max="02:00" je 23:00 v povoleném rozsahu, přestože jde o pozdější čas než max.
checked je logická hodnota popisující aktuální zaškrtnutý stav prvku checkbox nebo radio, nikoli jeho textovou value. Atribut checked určuje výchozí stav, který odráží defaultChecked; změna aktuálního zaškrtnutí tento atribut neaktualizuje. disabled odráží logický atribut: nastavení na true zabrání interakci, vyloučí prvek z odesílaných dat formuláře a z validace omezení. Není to totéž co readOnly.
validationMessage je řetězec pouze pro čtení, který obsahuje lokalizovanou chybovou zprávu, nebo "", pokud prvek splňuje svá omezení či je z validace vyloučen. Prázdná zpráva tedy nedokazuje, že zakázaný prvek má platnou hodnotu. Vlastní zprávu nastavte pomocí setCustomValidity() a vymažte pomocí setCustomValidity(""). Příklad ověřuje, zda je zpráva prázdná, místo aby porovnával text závislý na jazyce, a nepokouší se ukázat chybu minLength přiřazením ze skriptu.
Referenční identifikátory zahrnuté v tomto hesle: HTMLInputElement.validationMessage, HTMLInputElement.minLength, HTMLInputElement.type, HTMLInputElement.checked, HTMLInputElement.max, HTMLInputElement.disabled.
Příklady
(() => {
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 === "");
})();Výsledek
text 3 true false 10 true true true false true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.
Zdroje
- 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