CKTIS / HTML
aria-labelledby — un nom issu d’éléments existants
`aria-labelledby` construit un nom accessible à partir du texte d’éléments référencés par leurs identifiants.
Version : WAI-ARIA 1.2
Syntaxe
<button aria-labelledby="verb topic">Download</button>Les identifiants sont séparés par des espaces ; l’ordre des références définit celui des fragments du nom. Utilisez des identifiants stables et uniques ainsi que de véritables étiquettes, pas de longs contenus sans rapport.
Une référence valide est prioritaire sur aria-label. Elle ne remplace ni une description supplémentaire ni le comportement d’une étiquette native : cliquer sur le texte référencé ne donne pas automatiquement le focus au champ. Pour les champs ordinaires, préférez l’association native entre étiquette et contrôle.
Dans l’exemple, report apparaît plus tôt dans le DOM, mais la liste de références forme Download report. Le test de l’arbre d’accessibilité confirme cet ordre et écarte le nom de secours Fallback. Modifier la disposition de la page n’exige pas de modifier l’ordre du nom.
Exemples
<!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>Résultat
referenceOrder=Download report
Le nom calculé, l’ordre des références et la priorité sur l’étiquette textuelle ont été vérifiés.