KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

aria-labelledby — een naam uit bestaande elementen

`aria-labelledby` maakt een toegankelijke naam uit de tekst van elementen waarnaar identificaties verwijzen.

Versie: WAI-ARIA 1.2

Syntax

<button aria-labelledby="verb topic">Download</button>

Identificaties worden gescheiden door spaties; de verwijzingsvolgorde bepaalt de volgorde van de naamdelen. Gebruik stabiele unieke identificaties en echte labels, geen ongerelateerde lange inhoud.

Een geldige verwijzing heeft voorrang op aria-label. Ze vervangt geen aanvullende beschrijving of native labelgedrag: klikken op de aangewezen tekst geeft een invoerveld niet automatisch focus. Geef bij gewone velden de voorkeur aan de native relatie tussen label en bedieningselement.

In het voorbeeld staat report eerder in de DOM, maar de verwijzingslijst vormt Download report. De test van de toegankelijkheidsboom bevestigt die volgorde en sluit de terugvalnaam Fallback uit. Een andere pagina-indeling vereist geen andere naamvolgorde.

Voorbeelden

<!doctype html><meta charset="utf-8">
<span id="topic">report</span>
<button id="download" aria-label="Fallback" aria-labelledby="verb topic"><span id="verb">Download</span></button>
<output id="result"></output>
<script>
document.querySelector('#result').textContent = 'referenceOrder=' + document.querySelector('#download').getAttribute('aria-labelledby').split(' ').map(id => document.getElementById(id).textContent).join(' ');
</script>

Resultaat

referenceOrder=Download report

De berekende naam, verwijzingsvolgorde en voorrang op het tekstlabel zijn gecontroleerd.

Bronnen