CKTIS / HTML
aria-label — textový prístupný názov
`aria-label` dáva prístupný názov prvku, ktorého rola povoľuje pomenovanie autorom.
Verzia: WAI-ARIA 1.2
Syntax
<button aria-label="Close notice">×</button>Uveď krátky lokalizovaný názov akcie, napríklad Close notice pre zatváracie tlačidlo. Atribút nedáva ľubovoľnému prvku rolu. Ak môžeš použiť viditeľný text alebo natívne označenie, býva to vhodnejšie.
Názov môže nahradiť text obsahu. Zahrň viditeľné označenie, aby hlasové ovládanie zodpovedalo obrazovke. Platné aria-labelledby má prednosť. Nie je to bublina, návod na obsluhu ani obsluha udalosti.
Ikonové tlačidlo v príklade má názov Close notice a jeho dekoratívny znak je vynechaný z prístupnosti. Samostatná funkcia po aktivácii skryje oznámenie. Test potvrdí vypočítaný názov aj zatvorenie; názov prekladaj spolu s rozhraním.
Príklady
<!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>Výsledok
noticeHidden=true
Overený je názov aj akcia tlačidla; samotná ARIA oznámenie nezatvorí.