CKTIS / HTML
role — role prvku z hlediska přístupnosti
Atribut `role` určuje sémantickou roli prvku pro asistivní technologie. Nepřidává vzhled ani chování. Používejte ho podle pravidel ARIA in HTML a upřednostňujte prvky, které již poskytují odpovídající nativní sémantiku.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
role="role-name [fallback-role-name ...]"Atribut role sděluje asistivním technologiím typ prvku, například skupinu nebo tlačítko. Týká se sémantiky ve stromu přístupnosti, nikoli vzhledu. Nenahrazuje přístupný název: v příkladu určuje group roli a aria-label poskytuje název Display options.
Hodnota může obsahovat názvy rolí oddělené bílými znaky. Při určování role prohlížeč použije první rozpoznaný název neabstraktní role. Seznam poskytuje záložní role, nikoli několik rolí současně. Takto vybraná role se však nemusí shodovat s rolí zpřístupněnou ve stromu přístupnosti. Například u prvku button, který může získat fokus, musí prohlížeč ignorovat none či presentation a ve stromu přístupnosti místo nich zpřístupnit implicitní roli tlačítka. Abstraktní role se nesmějí používat v obsahu stránky.
Upřednostňujte nativní prvek HTML s odpovídající sémantikou. button již má roli tlačítka, takže její opakování je nadbytečné. Povolené přepsání závisí na prvku a pravidlech ARIA in HTML; ne každá role je platná všude. Splňujte také požadavky zvolené role na názvy, stavy a strukturu.
Samotné přidání role="button" nezajistí ovládání klávesnicí, možnost získat fokus ani akce. Příklad sdružuje dva nativní přepínače (<input type="radio">), aniž by přepisoval jejich role. Při změně vybrané možnosti skript změní velikost písma ukázkového textu. output je výpis z konzole: obsahuje deklarované hodnoty atributů role a aria-label a viditelný text skupiny. Nejde o výsledek kontroly stromu přístupnosti.
Pří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ýsledek
Declared role: group ARIA label: Display options Visible group text: Normal size Large size
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.