KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / CSS

:disabled — pseudoklasse voor uitgeschakelde elementen

De pseudoklasse :disabled selecteert elementen die volgens de HTML-regels daadwerkelijk zijn uitgeschakeld, niet alleen elementen met een disabled-attribuut. Hiermee kun je de status van een besturingselement vormgeven, maar je schakelt het element er niet mee uit.

Versie: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Syntax

:disabled

De pseudoklasse :disabled komt overeen met interface-elementen in de uitgeschakelde status zoals die door de documenttaal is gedefinieerd. In HTML gaat het om daadwerkelijk uitgeschakelde elementen button, input, select, textarea, optgroup, option en fieldset, plus aangepaste elementen die aan een formulier zijn gekoppeld. button:disabled beperkt de selectie tot knoppen.

Stel :disabled niet gelijk aan [disabled]: die tweede selector controleert alleen of het attribuut aanwezig is. Een besturingselement binnen een uitgeschakelde fieldset kan overeenkomen met :disabled zonder zelf een disabled-attribuut te hebben. De uitschakeling door die fieldset geldt niet voor afstammelingen van het eerste legend-kind; zij kunnen om een andere reden nog steeds uitgeschakeld zijn. Het voorbeeld laat dit verschil zien.

De selector herkent alleen de status — een CSS-regel schakelt een besturingselement niet uit. Eigenschappen zoals display en visibility veranderen de overeenkomst met :disabled niet. Ook betekent readonly op zichzelf niet dat een element is uitgeschakeld. :enabled is niet voor alle elementen hetzelfde als :not(:disabled): een gewone alinea komt niet overeen met :enabled of :disabled, maar wel met :not(:disabled).

In het voorbeeld krijgen de knoppen inherited en direct een rode omtrek en is het tekstresultaat inherited, direct. De knop exception valt onder de uitzondering voor het eerste legend, terwijl available ingeschakeld blijft. De tekstuitvoer is gecontroleerd in een geïsoleerde browseromgeving.

Voorbeelden

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>:disabled example</title>
<style>
  button:disabled { outline: 3px solid #b00020; }
</style>
<fieldset disabled>
  <legend><button id="exception" type="button">Exception</button></legend>
  <button id="inherited" type="button">Inherited</button>
</fieldset>
<button id="direct" type="button" disabled>Direct</button>
<button id="available" type="button">Available</button>
<pre id="result"></pre>
<script>
  const ids = Array.from(document.querySelectorAll('button:disabled'),
    button => button.id);
  document.getElementById('result').textContent = ids.join(', ');
</script>
</html>

Resultaat

inherited, direct

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