CKTIS / JavaScript
HTMLInputElement: invoertype, status en beperkingen
Leer zes eigenschappen van HTMLInputElement kennen om een invoertype te kiezen, de aangevinkte status uit te lezen, beperkingen in te stellen en een bedieningselement uit te schakelen. Onderscheid de huidige status van beginattributen en een validatiemelding van het validatieresultaat zelf.
Versie: 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 is de DOM-interface van de browser voor invoervelden en maakt geen deel uit van ECMAScript zelf. type is een tekenreeks die het soort bedieningselement kiest, zoals text, number of checkbox; het type bepaalt welke andere beperkingen van toepassing zijn. Deze eigenschappen zijn breed beschikbaar in moderne browsers, maar de UI-ondersteuning voor afzonderlijke invoertypen kan verschillen. Node 24 alleen toont niet aan dat deze API wordt ondersteund.
minLength is de numerieke weerspiegeling van het attribuut minlength: het stelt de minimale tekstlengte in UTF-16-code-eenheden in, wat niet noodzakelijk overeenkomt met tekens zoals gebruikers die ervaren. -1 betekent dat er geen minimum is. De eigenschap geldt voor tekstachtige typen, vereist zonder required geen niet-lege waarde, en validatie van te korte tekst heeft betrekking op wijzigingen door de gebruiker, niet alleen op een toewijzing door een script. max is een tekenreeks, zoals "10", die voor de betreffende typen de bovengrens voor getallen, datums of tijdstippen instelt; anders dan maxLength beperkt deze eigenschap niet de tekstlengte. Bij type="time" herhalen de tijdstippen zich elke 24 uur: als min een later tijdstip aangeeft dan max, loopt het toegestane bereik van min via middernacht tot max. Met min="22:00" en max="02:00" valt 23:00 bijvoorbeeld binnen het bereik, ook al is het later dan max.
checked is een booleaanse waarde die de huidige aangevinkte status van een checkbox- of radio-veld beschrijft, niet de tekstuele value. Het attribuut checked bepaalt de standaardstatus, die door defaultChecked wordt weerspiegeld; een wijziging van de huidige aangevinkte status werkt dat attribuut niet bij. disabled weerspiegelt een booleaans attribuut: instellen op true voorkomt interactie, sluit het bedieningselement uit van verzonden formuliergegevens en van constraintvalidatie. Het is niet hetzelfde als readOnly.
validationMessage is een alleen-lezen tekenreeks met een gelokaliseerde foutmelding, of "" wanneer het bedieningselement aan de beperkingen voldoet of van validatie is uitgesloten. Een lege melding bewijst dus niet dat een uitgeschakeld bedieningselement een geldige waarde heeft. Stel een eigen melding in met setCustomValidity() en wis deze met setCustomValidity(""). Het voorbeeld controleert of de melding leeg is in plaats van taalafhankelijke tekst te vergelijken en probeert geen minLength-fout te demonstreren met een scripttoewijzing.
Referentie-identificatoren die in dit item worden behandeld: HTMLInputElement.validationMessage, HTMLInputElement.minLength, HTMLInputElement.type, HTMLInputElement.checked, HTMLInputElement.max, HTMLInputElement.disabled.
Voorbeelden
(() => {
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 === "");
})();Resultaat
text 3 true false 10 true true true false true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.
Bronnen
- 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