Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

aria-label — textový přístupný název

`aria-label` dává přístupný název prvku, jehož role dovoluje pojmenování autorem.

Verze: WAI-ARIA 1.2

Syntaxe

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

Uveď krátký lokalizovaný název akce, například Close notice pro zavírací tlačítko. Atribut nedává libovolnému prvku roli. Pokud je možný viditelný text nebo nativní označení, zpravidla je vhodnější.

Název může nahradit text obsahu. Zahrň viditelnou etiketu, aby hlasové ovládání odpovídalo obrazovce. Platné aria-labelledby má přednost. Nejde o bublinu, návod k obsluze ani obsluhu události.

Ikonové tlačítko v příkladu nese název Close notice a jeho dekorativní znak je vynechán z přístupnosti. Samostatná funkce po aktivaci skryje oznámení. Test potvrzuje vypočtený název a zavření; text názvu překládej společně s rozhraním.

Pří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ýsledek

noticeHidden=true

Ověřen je název i akce tlačítka; samotná ARIA oznámení nezavře.

Zdroje