CKTIS / HTML
aria-label — besedilno dostopno ime
`aria-label` določi dostopno ime elementu, katerega vloga dovoljuje poimenovanje avtorju.
Različica: WAI-ARIA 1.2
Sintaksa
<button aria-label="Close notice">×</button>Navedi kratko prevedeno ime dejanja, na primer Close notice za gumb zapiranja. Atribut poljubnemu elementu ne dodeli vloge. Če lahko uporabiš vidno besedilo ali vgrajeno oznako, je to navadno boljša rešitev.
Ime lahko nadomesti besedilo vsebine. Vključi vidno oznako, da glasovno upravljanje ustreza zaslonu. Veljaven aria-labelledby ima prednost. To ni pojavni namig, navodilo za delovanje ali obdelovalnik dogodka.
Ikonski gumb v primeru ima ime Close notice, okrasni znak pa je izločen iz dostopnosti. Ločena funkcija po aktivaciji skrije obvestilo. Test potrdi izračunano ime in zaprtje; ime prevedi skupaj z vmesnikom.
Primeri
<!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>Rezultat
noticeHidden=true
Preverjena sta ime gumba in dejanje; sama ARIA obvestila ne zapre.