KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

aria-label — een toegankelijke naam als tekst

`aria-label` geeft een toegankelijke naam aan een element waarvan de rol door de auteur opgegeven namen toestaat.

Versie: WAI-ARIA 1.2

Syntax

<button aria-label="Close notice">×</button>

Geef een korte vertaalde actienaam, zoals Close notice voor een sluitknop. Het attribuut geeft willekeurige elementen geen rol. Waar zichtbare tekst of een native label mogelijk is, verdient dat meestal de voorkeur.

De naam kan inhoudstekst vervangen. Neem het zichtbare label op zodat spraakbediening bij het scherm past. Een geldig aria-labelledby heeft voorrang. Dit is geen tooltip, bedieningsinstructie of gebeurtenisafhandeling.

De pictogramknop in het voorbeeld heet Close notice; zijn decoratieve teken is uitgesloten van toegankelijkheid. Een aparte functie verbergt de melding bij activering. De test bevestigt de berekende naam en het sluiten; vertaal het label samen met de interface.

Voorbeelden

<!doctype html><meta charset="utf-8">
<p id="notice">Your settings were saved.</p>
<button id="close" aria-label="Close notice"><span aria-hidden="true">×</span></button>
<output id="result"></output>
<script>
document.querySelector('#close').addEventListener('click', () => { document.querySelector('#notice').hidden = true; });
document.querySelector('#close').click();
document.querySelector('#result').textContent = 'noticeHidden=' + document.querySelector('#notice').hidden;
</script>

Resultaat

noticeHidden=true

Naam en actie van de knop zijn gecontroleerd; ARIA alleen sluit de melding niet.

Bronnen