Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

aria-label — tekstowa nazwa dostępna

`aria-label` nadaje elementowi nazwę dostępną wtedy, gdy jego rola dopuszcza nazewnictwo przez autora.

Wersja: WAI-ARIA 1.2

Składnia

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

Podaj krótki, przetłumaczony opis działania, na przykład Close notice dla przycisku zamknięcia. Sam atrybut nie nadaje roli dowolnemu elementowi. Gdy można użyć widocznego tekstu lub natywnej etykiety, zwykle jest to lepszy wybór.

Nazwa może zastąpić tekst zawartości. Niech obejmuje widoczną etykietę, aby sterowanie głosem pasowało do ekranu. Poprawne aria-labelledby ma pierwszeństwo. To nie dymek, instrukcja działania ani obsługa zdarzeń.

W przykładzie przycisk z ikoną ma nazwę Close notice, a dekoracyjny znak jest pominięty w dostępności. Osobna funkcja ukrywa powiadomienie po aktywacji. Test potwierdza obliczoną nazwę i zamknięcie komunikatu; tekst etykiety należy lokalizować razem z interfejsem.

Przykłady

<!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>

Wynik

noticeHidden=true

Zweryfikowano nazwę przycisku i jego działanie; ARIA samo nie zamyka powiadomienia.

Źródła