Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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