Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

HTMLInputElement: vrsta, stanje i ograničenja polja

Upoznajte šest svojstava HTMLInputElement za odabir vrste polja, čitanje stanja označenosti, postavljanje ograničenja i onemogućavanje kontrole. Razlikujte trenutačno stanje od početnih atributa te poruku provjere valjanosti od samog rezultata provjere.

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

Sintaksa

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

HTMLInputElement je DOM sučelje preglednika za polja za unos, a ne dio samog ECMAScripta. type je niz koji odabire vrstu kontrole, primjerice text, number ili checkbox; vrsta određuje koja se druga ograničenja primjenjuju. Ta su svojstva široko dostupna u modernim preglednicima, ali podrška sučelja za pojedine vrste polja može se razlikovati. Sam Node 24 ne potvrđuje podršku za ovaj API.

minLength je numerički odraz atributa minlength: postavlja minimalnu duljinu teksta u UTF-16 kodnim jedinicama, koje ne moraju odgovarati znakovima kako ih korisnik doživljava. -1 znači da minimalna duljina nije postavljena. Svojstvo se primjenjuje na tekstualne vrste, bez required ne zahtijeva nepraznu vrijednost, a provjera prekratkog teksta odnosi se na korisničke izmjene, ne samo na dodjelu vrijednosti skriptom. max je niz, primjerice "10", koji za odgovarajuće vrste postavlja gornju granicu brojčane vrijednosti, datuma ili vremena; za razliku od maxLength, ne ograničava duljinu teksta. Kod type="time" vremena se ponavljaju u 24-satnom ciklusu: ako min označava kasnije doba dana nego max, dopušteni raspon proteže se od min preko ponoći do max. Primjerice, uz min="22:00" i max="02:00" vrijeme 23:00 unutar je dopuštenog raspona iako je kasnije od max.

checked je logička vrijednost koja opisuje trenutačno stanje označenosti polja checkbox ili radio, a ne njegov tekstualni value. Atribut checked određuje zadano stanje, koje odražava defaultChecked; promjena trenutačne označenosti ne ažurira taj atribut. disabled odražava logički atribut: postavljanje na true sprječava interakciju, isključuje kontrolu iz poslanih podataka obrasca i iz provjere ograničenja. Nije isto što i readOnly.

validationMessage je niz samo za čitanje koji sadrži lokaliziranu poruku o pogrešci ili "" kada kontrola zadovoljava svoja ograničenja ili je izuzeta iz provjere. Prazna poruka zato ne dokazuje da onemogućena kontrola ima valjanu vrijednost. Vlastitu poruku postavite s setCustomValidity(), a uklonite je s setCustomValidity(""). Primjer provjerava je li poruka prazna umjesto da uspoređuje tekst ovisan o jeziku i ne pokušava prikazati pogrešku minLength dodjelom vrijednosti skriptom.

Referentni identifikatori obuhvaćeni ovim unosom: HTMLInputElement.validationMessage, HTMLInputElement.minLength, HTMLInputElement.type, HTMLInputElement.checked, HTMLInputElement.max, HTMLInputElement.disabled.

Primjeri

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

Rezultat

text 3
true false
10 true
true
true false
true

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori