CKTIS / JavaScript
HTMLInputElement: typ, stav a obmedzenia vstupného poľa
Spoznajte šesť vlastností HTMLInputElement na výber typu poľa, zistenie stavu začiarknutia, nastavenie obmedzení a zakázanie ovládacieho prvku. Rozlišujte aktuálny stav od počiatočných atribútov a validačné hlásenie od samotného výsledku validácie.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
input.validationMessage; input.minLength = 3; input.type = "text"; input.checked = true; input.max = "10"; input.disabled = true;HTMLInputElement je rozhranie DOM prehliadača pre vstupné prvky, nie súčasť samotného ECMAScriptu. type je reťazec, ktorý vyberá typ ovládacieho prvku, napríklad text, number alebo checkbox; typ určuje, ktoré ďalšie obmedzenia sa uplatnia. Tieto vlastnosti sú v moderných prehliadačoch široko dostupné, no podpora rozhrania pre jednotlivé typy polí sa môže líšiť. Samotný Node 24 nepotvrdzuje podporu tohto API.
minLength je číselným odrazom atribútu minlength: nastavuje minimálnu dĺžku textu v jednotkách kódu UTF-16, ktoré nemusia zodpovedať znakom vnímaným používateľom. Hodnota -1 znamená, že nie je určená žiadna minimálna dĺžka. Vlastnosť sa vzťahuje na textové typy, bez required nevyžaduje neprázdnu hodnotu a validácia príliš krátkeho textu sa týka zmien používateľa, nie samotného priradenia zo skriptu. max je reťazec, napríklad "10", ktorý pre príslušné typy nastavuje hornú hranicu číselnej hodnoty, dátumu alebo času; na rozdiel od maxLength neobmedzuje dĺžku textu. Pri type="time" sa časy opakujú v 24-hodinovom cykle: ak min označuje neskorší čas než max, povolený rozsah siaha od min cez polnoc až po max. Napríklad pri min="22:00" a max="02:00" patrí 23:00 do povoleného rozsahu, hoci ide o neskorší čas než max.
checked je logická hodnota opisujúca aktuálny začiarknutý stav prvku checkbox alebo radio, nie jeho textovú value. Atribút checked určuje predvolený stav, ktorý odráža defaultChecked; zmena aktuálneho začiarknutia tento atribút neaktualizuje. disabled odráža logický atribút: nastavenie na true zabráni interakcii, vylúči prvok z odosielaných údajov formulára aj z validácie obmedzení. Nie je to to isté ako readOnly.
validationMessage je reťazec iba na čítanie, ktorý obsahuje lokalizované chybové hlásenie alebo "", ak prvok spĺňa svoje obmedzenia alebo je z validácie vylúčený. Prázdne hlásenie teda nedokazuje, že zakázaný prvok má platnú hodnotu. Vlastné hlásenie nastavte pomocou setCustomValidity() a vymažte pomocou setCustomValidity(""). Príklad kontroluje, či je hlásenie prázdne, namiesto porovnávania textu závislého od jazyka, a nepokúša sa ukázať chybu minLength priradením zo skriptu.
Referenčné identifikátory zahrnuté v tomto hesle: HTMLInputElement.validationMessage, HTMLInputElement.minLength, HTMLInputElement.type, HTMLInputElement.checked, HTMLInputElement.max, HTMLInputElement.disabled.
Prí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ýsledok
text 3 true false 10 true true true false true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.
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