CKTIS / JavaScript
HTMLInputElement.max en disabled: waardelimiet en invoerveld uitschakelen
`max` weerspiegelt de bovengrens als tekenreeks en `disabled` geeft aan of het veld zelf het attribuut voor uitschakeling heeft. Een te hoge waarde schakelt het veld niet uit.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
input.max; // string: the max attribute, or "" if absent
input.max = "10"; // set the max attribute
input.removeAttribute("max");
input.disabled; // boolean: whether the input's own disabled attribute is present
input.disabled = true; // add the disabled attribute
input.disabled = false; // remove the disabled attribute
input.matches(":disabled"); // test whether the input is effectively disabledinput.max is een schrijfbare tekenreekseigenschap die het HTML-attribuut max weerspiegelt. De eigenschap geeft de attribuuttekst terug, of "" als het attribuut ontbreekt, niet de berekende bovengrens. input.max = "10" stelt het attribuut in en input.removeAttribute("max") verwijdert het.
max geldt voor number, range, date, month, week, time en datetime-local; het formaat hangt af van het type. Het beperkt de tekstlengte niet. Als het attribuut ontbreekt of niet kan worden geïnterpreteerd, geldt de standaardbovengrens van het type, als die er is: 100 voor range; number heeft geen standaardbovengrens. In een number-veld blijft een getal boven de grens in value staan en geldt validity.rangeOverflow === true. Een range-schuifregelaar past de waarde juist aan het bereik aan. Een time-bereik met min groter dan max kan over middernacht heen lopen.
De schrijfbare booleaanse eigenschap input.disabled weerspiegelt of het veld zelf het attribuut disabled heeft. true voegt het toe en false verwijdert het. Ook disabled="false" schakelt het veld uit. Een uitgeschakelde fieldset schakelt ook onderliggende invoervelden uit, behalve die binnen het eerste directe legend-kind. Daarom kan input.disabled false zijn terwijl input.matches(":disabled") true teruggeeft.
Een gebruiker kan een uitgeschakeld invoerveld niet selecteren voor invoer of bewerken, maar JavaScript kan de waarde nog wijzigen. Het veld doet niet mee aan de validatie van invoerbeperkingen (willValidate is false) en wordt weggelaten bij het versturen van het formulier en bij new FormData(form). Deze eigenschappen horen bij het browser-DOM, niet bij ECMAScript; een runtime zonder DOM biedt ze niet. Valideer ontvangen gegevens altijd op de server, ongeacht de veldinstellingen.
Voorbeelden
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Input max and disabled</title>
</head>
<body>
<script>
const form = document.createElement('form');
const input = document.createElement('input');
input.type = 'number';
input.name = 'quantity';
input.max = '10';
input.value = '12';
form.append(input);
console.log(JSON.stringify([
input.max, input.value, input.validity.rangeOverflow,
input.checkValidity(), new FormData(form).has('quantity'),
]));
input.disabled = true;
console.log(JSON.stringify([
input.disabled, input.value, input.willValidate,
new FormData(form).has('quantity'),
]));
</script>
</body>
</html>Resultaat
["10","12",true,false,true] [true,"12",false,false]
Sla het voorbeeld op als `.html`-bestand, open het in een browser en bekijk de uitvoer in de browserconsole. `"12"` is groter dan `"10"` en komt niet door de validatie, maar staat wel in `FormData`. Na uitschakeling behoudt het veld zijn waarde, maar doet het niet meer mee aan de validatie en staat het niet in de formuliergegevens.
Gerelateerde lessen
- JavaScript · Les 28 · Gemiddeld · Versie: 3
Bronnen
- HTMLInputElement: max property
- HTMLInputElement: disabled property
- HTML Standard — The min and max attributes
- HTML Standard — Range state (type=range)
- HTML Standard — Enabling and disabling form controls: the disabled attribute
- HTML Standard — Constructing the entry list
- Using HTML form validation and the Constraint Validation API