KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

HTMLButtonElement.disabled — een knop uitschakelen

HTMLButtonElement.disabled is een booleaanse eigenschap die aangeeft of het disabled-attribuut van een knop aanwezig is. Hiermee kun je een knop uitschakelen of het eigen disabled-attribuut verwijderen, maar de eigenschap beschrijft niet alle redenen waarom het bedieningselement uitgeschakeld kan zijn.

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

button.disabled; button.disabled = true; button.disabled = false;

HTMLButtonElement.disabled is een leesbare en beschrijfbare booleaanse eigenschap van de knopinterface. De eigenschap weerspiegelt het eigen disabled-attribuut van de knop: toewijzing van true voegt het attribuut toe, terwijl false het verwijdert. Dit is een browser-API die is gedefinieerd door de HTML Standard, geen functie van ECMAScript zelf; de beschikbaarheid van Node 24 bewijst niet dat deze API wordt ondersteund.

Een uitgeschakelde knop reageert niet op normale gebruikersactivering en het naam-waardepaar wordt niet met het formulier verzonden. Het attribuut is booleaans: de aanwezigheid telt, niet de tekstwaarde. Daarom schakelt button.setAttribute('disabled', 'false') de knop nog steeds uit; gebruik button.disabled = false om het attribuut te verwijderen.

De eigenschapswaarde is geen volledige test voor de feitelijke uitgeschakelde toestand. Een knop kan disabled === false hebben en toch uitgeschakeld zijn door een bovenliggend fieldset met het attribuut disabled. Afstammelingen van het eerste legend-element dat een kind is van dat fieldset, zijn vrijgesteld van dit uitschakelingseffect. Alleen button.disabled = false instellen maakt de uitschakeling door een bovenliggend element niet ongedaan.

Voorbeelden

const button = document.createElement('button');
button.type = 'button';
console.log(button.disabled);

button.disabled = true;
console.log(button.disabled, button.hasAttribute('disabled'));

button.disabled = false;
console.log(button.disabled, button.hasAttribute('disabled'));

button.setAttribute('disabled', 'false');
console.log(button.disabled);

Resultaat

false
true true
false 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