CKTIS / HTML
role — rola prvku z hľadiska prístupnosti
Atribút `role` určuje sémantickú rolu prvku pre asistenčné technológie. Nepridáva vzhľad ani správanie. Používajte ho podľa pravidiel ARIA in HTML a uprednostňujte prvky, ktoré už poskytujú vhodnú natívnu sémantiku.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
role="role-name [fallback-role-name ...]"Atribút role oznamuje asistenčným technológiám typ prvku, napríklad skupinu alebo tlačidlo. Týka sa sémantiky v strome prístupnosti, nie vzhľadu. Nenahrádza prístupný názov: v príklade určuje group rolu a aria-label poskytuje názov Display options.
Hodnota môže obsahovať názvy rolí oddelené bielymi znakmi. Pri určovaní roly prehliadač použije prvý rozpoznaný názov neabstraktnej roly. Zoznam poskytuje záložné roly, nie viacero súčasne platných rolí. Takto vybraná rola sa však nemusí zhodovať s rolou sprístupnenou v strome prístupnosti. Napríklad pri prvku button, ktorý môže získať fokus, musí prehliadač ignorovať none alebo presentation a namiesto toho v strome prístupnosti sprístupniť implicitnú rolu tlačidla. Abstraktné roly sa nesmú používať v obsahu stránky.
Uprednostňujte natívny prvok HTML s vhodnou sémantikou. button už má rolu tlačidla, takže jej opakovanie je nadbytočné. Povolené prepísania závisia od prvku a pravidiel ARIA in HTML; nie každá rola je platná všade. Spĺňajte aj požiadavky vybranej roly na názvy, stavy a štruktúru.
Samotné pridanie role="button" nezabezpečí ovládanie klávesnicou, možnosť získať fokus ani akcie. Príklad zoskupuje dva natívne prepínače (<input type="radio">) bez prepísania ich rolí. Pri zmene vybratej možnosti skript zmení veľkosť písma ukážkového textu. output je výpis z konzoly: obsahuje deklarované hodnoty atribútov role a aria-label a viditeľný text skupiny. Nejde o výsledok kontroly stromu prístupnosti.
Príklady
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Named group of display options</title>
</head>
<body>
<div id="display-options" role="group" aria-label="Display options">
<label><input type="radio" name="zoom" value="normal" checked> Normal size</label>
<label><input type="radio" name="zoom" value="large"> Large size</label>
</div>
<p id="sample">Sample text</p>
<script>
const group = document.getElementById('display-options');
const sample = document.getElementById('sample');
group.addEventListener('change', event => {
sample.style.fontSize = event.target.value === 'large' ? '1.5em' : '1em';
});
console.log('Declared role: ' + group.getAttribute('role'));
console.log('ARIA label: ' + group.getAttribute('aria-label'));
console.log('Visible group text: ' + group.innerText.trim().replace(/\s+/g, ' '));
</script>
</body>
</html>Výsledok
Declared role: group ARIA label: Display options Visible group text: Normal size Large size
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.