CKTIS / HTML
aria-disabled — uitgeschakelde status van een bedieningselement
aria-disabled laat hulptechnologieën weten dat een element waarneembaar is, maar niet beschikbaar voor gebruik. Het attribuut alleen voorkomt geen acties en verwijdert het element niet uit de focusvolgorde; de auteur moet dit gedrag zelf implementeren.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
aria-disabled="true" | aria-disabled="false"aria-disabled="true" geeft aan dat een element is uitgeschakeld, maar nog wel waarneembaar is. aria-disabled="false" is de standaardwaarde voor deze status; het overschrijft native disabled echter niet. Dit is geen booleaans HTML-attribuut: geef expliciet "true" of "false" op in plaats van te vertrouwen op de aanwezigheid van het attribuut.
In tegenstelling tot native disabled voorkomt aria-disabled op zichzelf geen activering, verandert het de focusvolgorde niet en zorgt het niet voor een uitgeschakelde vormgeving. Gebruik bij voorkeur native disabled als dat aan de vereisten voldoet. Als een niet-beschikbare knop met Tab bereikbaar moet blijven, vereist het gebruik van aria-disabled ook dat een script de actie onderdrukt en dat de status visueel wordt aangegeven.
De status geldt voor het element en al zijn focusbare afstammelingen. Pas deze daarom niet zomaar toe op containers. Gebruik hem alleen waar de HTML-regels en de rol van het element dit toestaan. ARIA 1.2 raadt het gebruik als globale status af, niet het attribuut zelf.
In het voorbeeld behoudt de native knop de toetsenbordbediening, maar keert de gedeelde click-handler terug voordat de actie wordt uitgevoerd. CSS geeft alleen aan dat de knop niet beschikbaar is; het dwingt dit niet af.
Voorbeelden
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>aria-disabled demo</title>
<style>
button[aria-disabled="true"] { opacity: 0.6; }
</style>
<button type="button" id="save" aria-disabled="true">Save (unavailable)</button>
<p id="result">Actions: 0</p>
<script>
const save = document.getElementById('save');
const result = document.getElementById('result');
let actions = 0;
save.addEventListener('click', () => {
if (save.getAttribute('aria-disabled') === 'true') return;
actions += 1;
result.textContent = `Actions: ${actions}`;
});
save.click();
console.log(result.textContent);
</script>
</html>Resultaat
Actions: 0
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.