CKTIS / JavaScript
HTMLInputElement: vrsta, stanje in omejitve polja
Spoznajte šest lastnosti HTMLInputElement za izbiro vrste polja, branje stanja označenosti, določanje omejitev in onemogočanje kontrolnika. Ločite trenutno stanje od začetnih atributov ter validacijsko sporočilo od samega rezultata preverjanja.
Različica: 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 vmesnik DOM v brskalniku za vhodna polja in ni del samega ECMAScripta. type je niz, ki izbere vrsto kontrolnika, na primer text, number ali checkbox; vrsta določa, katere druge omejitve veljajo. Te lastnosti so v sodobnih brskalnikih široko podprte, vendar se lahko podpora uporabniškega vmesnika za posamezne vrste polj razlikuje. Node 24 sam po sebi ne potrjuje podpore za ta API.
minLength je številski odsev atributa minlength: določa najmanjšo dolžino besedila v kodnih enotah UTF-16, ki se ne ujemajo nujno z znaki, kot jih zazna uporabnik. -1 pomeni, da najmanjša dolžina ni določena. Lastnost velja za besedilne vrste, brez required ne zahteva neprazne vrednosti, preverjanje prekratkega besedila pa se nanaša na uporabnikove spremembe in ne zgolj na dodelitev s skriptom. max je niz, na primer "10", ki za ustrezne vrste določa zgornjo mejo številske vrednosti, datuma ali časa; za razliko od maxLength ne omejuje dolžine besedila. Pri type="time" se ure ponavljajo v 24-urnem ciklu: če min označuje poznejšo uro kot max, dovoljeno območje sega od min čez polnoč do max. Pri min="22:00" in max="02:00" je na primer 23:00 znotraj dovoljenega območja, čeprav je to poznejša ura kot max.
checked je logična vrednost, ki opisuje trenutno stanje označenosti polja checkbox ali radio, ne pa njegove besedilne vrednosti value. Atribut checked določa privzeto stanje, ki ga odraža defaultChecked; sprememba trenutne označenosti tega atributa ne posodobi. disabled odraža logični atribut: nastavitev na true prepreči interakcijo, kontrolnik izključi iz poslanih podatkov obrazca in iz preverjanja omejitev. Ni enakovreden lastnosti readOnly.
validationMessage je niz, ki je samo za branje in vsebuje lokalizirano sporočilo o napaki ali "", kadar kontrolnik izpolnjuje omejitve oziroma je iz preverjanja izključen. Prazno sporočilo torej ne dokazuje, da ima onemogočen kontrolnik veljavno vrednost. Sporočilo po meri nastavite z setCustomValidity() in ga izbrišite z setCustomValidity(""). Primer preveri, ali je sporočilo prazno, namesto da primerja besedilo, odvisno od jezika, in ne poskuša prikazati napake minLength z dodelitvijo prek skripta.
Referenčni identifikatorji, zajeti v tem geslu: HTMLInputElement.validationMessage, HTMLInputElement.minLength, HTMLInputElement.type, HTMLInputElement.checked, HTMLInputElement.max, HTMLInputElement.disabled.
Primeri
(() => {
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.
Viri
- 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