CKTIS / JavaScript
Uitgeschakelde formulierelementen
Gebruikers kunnen uitgeschakelde formulierelementen niet bedienen of focussen, en hun waarden worden niet verzonden. In JavaScript schakelt de eigenschap `disabled` de eigen uitgeschakelde status van een element om; een omringende `fieldset` kan het ook uitschakelen.
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
control.disabled = true;
control.disabled = false;
control.matches(':disabled');Uitgeschakelde formulierelementen zijn formulierelementen die zijn uitgeschakeld. Gebruikers kunnen ze niet bewerken of met een klik activeren; ze kunnen geen focus krijgen en nemen niet deel aan beperkingsvalidatie. Hun waarden worden overgeslagen bij het verzenden van het formulier. Dit is een mechanisme van HTML en de browser-DOM, geen functie van een bepaalde ECMAScript-editie. MDN vermeldt HTMLInputElement.disabled sinds juli 2015 als breed beschikbaar in browsers; de aanwezigheid van Node 24 bewijst geen DOM-ondersteuning.
De eigenschap input.disabled is een booleaanse waarde die het eigen disabled-attribuut van het element weerspiegelt. Door true toe te wijzen, wordt dat attribuut toegevoegd; door false toe te wijzen, wordt het verwijderd. Het attribuut is booleaans: ook disabled="false" betekent uitgeschakeld, omdat de aanwezigheid van het attribuut telt en niet de tekstuele waarde.
Een uitgeschakelde fieldset schakelt ook onderliggende besturingselementen uit, behalve die binnen het eerste legend-element dat een direct kind van die fieldset is. Dat een besturingselement zich binnen de legend van een geneste fieldset bevindt, voorkomt op zichzelf niet dat de buitenste fieldset het uitschakelt. Daarom kan input.disabled false zijn terwijl een bovenliggend element het besturingselement toch uitschakelt; gebruik input.matches(':disabled') om de effectieve status te controleren. Alleen input.disabled = false instellen heft de uitschakeling door een fieldset niet op.
Verwar disabled niet met readonly: ondersteunde alleen-lezenvelden kunnen nog steeds focus krijgen en hun waarden aan de formulierverzending bijdragen. readonly geldt voor teksttypen van input en voor textarea, maar bijvoorbeeld niet voor select of button. Het voorbeeld laat zien hoe je disabled omschakelt en hoe het veld daardoor uit FormData wordt weggelaten.
Voorbeelden
const form = document.createElement('form');
const input = document.createElement('input');
input.name = 'topic';
input.value = 'JavaScript';
form.append(input);
input.disabled = true;
console.log(input.disabled);
console.log(new FormData(form).has('topic'));
input.disabled = false;
console.log(new FormData(form).get('topic'));Resultaat
true false JavaScript
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.