CKTIS / JavaScript
HTML-formulierelementen uitschakelen met `disabled`
`disabled` schakelt een HTML-formulierelement uit en sluit het uit van validatie en formuliergegevens. De eigenschap `.disabled` en de selector `:disabled` controleren niet hetzelfde.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
<input name="city" disabled>
<script>
const input = document.querySelector('input[name="city"]');
input.disabled = true;
input.disabled = false;
input.matches(":disabled");
</script>disabled is een booleaans HTML-attribuut: alleen de aanwezigheid telt, dus ook disabled="false" schakelt het element uit. Dat geldt voor onder meer input, button, select, textarea en aangepaste elementen die aan een formulier gekoppeld zijn. Voor option en optgroup gelden aparte regels: bij een uitgeschakelde optgroup zijn de opties niet selecteerbaar, maar de select zelf wordt daardoor niet uitgeschakeld.
Een uitgeschakelde fieldset schakelt de onderliggende formulierelementen uit, behalve die binnen het eerste legend-element dat een direct kind van de fieldset is, als dat bestaat. Bij een input weerspiegelt .disabled alleen het eigen attribuut: true voegt het toe en false verwijdert het. Gebruik input.matches(":disabled") om de werkelijke status te controleren, inclusief het effect van een fieldset.
De gebruiker kan een uitgeschakeld element geen focus geven of het normaal bedienen, maar een script kan bijvoorbeeld input.value nog steeds wijzigen. De browser slaat het element over bij het valideren van invoerbeperkingen en bij het samenstellen van formuliergegevens, ook met new FormData(form). Bij tekstinvoervelden die readonly ondersteunen, verhindert dat attribuut bewerken door de gebruiker en sluit het het veld uit van validatie. Het verhindert op zichzelf echter niet dat het veld focus krijgt of in de formuliergegevens wordt opgenomen.
Dit zijn functies van het webplatform, niet van ECMAScript. Uitschakelen is geen beveiligingsmaatregel: valideer gegevens en controleer rechten op de server.
Voorbeelden
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Disabled form control</title>
</head>
<body>
<script>
const form = document.createElement("form");
const group = document.createElement("fieldset");
const input = document.createElement("input");
input.name = "city";
input.value = "Oslo";
group.append(input);
form.append(group);
const report = () => console.log(JSON.stringify([
input.disabled,
input.matches(":disabled"),
input.willValidate,
new FormData(form).has("city")
]));
group.disabled = true;
report();
group.disabled = false;
report();
</script>
</body>
</html>Resultaat
[false,true,false,false] [false,false,true,true]
Elke regel toont achtereenvolgens `.disabled`, of `:disabled` overeenkomt, `.willValidate` en of `city` in de formuliergegevens staat. Na het inschakelen van de `fieldset` veranderen de laatste drie resultaten; het invoerveld heeft nooit een eigen `disabled`-attribuut.
Gerelateerde lessen
- JavaScript · Les 20 · Gemiddeld · Versie: 3
- JavaScript · Les 21 · Gemiddeld · Versie: 3