CKTIS / HTML
role — rola dostępności elementu
Atrybut `role` określa semantyczną rolę elementu dla technologii asystujących. Nie dodaje wyglądu ani zachowania. Używaj go zgodnie z regułami ARIA w HTML i preferuj elementy z odpowiednią semantyką natywną.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
role="role-name [fallback-role-name ...]"Atrybut role przekazuje technologiom asystującym typ elementu, np. grupę lub przycisk. Dotyczy semantyki w drzewie dostępności, a nie wyglądu. Nie zastępuje nazwy dostępnej: w przykładzie group określa rolę, a aria-label nadaje nazwę Display options.
Wartość może zawierać nazwy ról oddzielone białymi znakami. Przy ustalaniu roli przeglądarka bierze pod uwagę pierwszą rozpoznaną nazwę roli nieabstrakcyjnej. Lista zapewnia role zapasowe, a nie kilka jednoczesnych ról. Wybrana w ten sposób rola nie zawsze jest jednak rolą ujawnianą w drzewie dostępności. Na przykład w przypadku elementu button, który może otrzymać fokus, przeglądarka musi zignorować rolę none lub presentation i zamiast niej ujawnić domyślną rolę przycisku. Ról abstrakcyjnych nie wolno używać w treści strony.
Preferuj natywny element HTML z właściwą semantyką. button ma już rolę przycisku, więc jej powtarzanie jest zbędne. Dozwolone nadpisania zależą od elementu i reguł ARIA w HTML; nie każda rola jest wszędzie poprawna. Spełniaj także wymagania wybranej roli dotyczące nazw, stanów i struktury.
Samo role="button" nie dodaje obsługi klawiatury, fokusu ani działania. Przykład grupuje dwa natywne pola wyboru jednokrotnego (<input type="radio">) bez nadpisywania ich ról. Po zmianie wybranej opcji skrypt zmienia rozmiar czcionki przykładowego tekstu. output zawiera wpisy z konsoli z zadeklarowanymi wartościami role i aria-label oraz widocznym tekstem grupy; nie jest wynikiem inspekcji drzewa dostępności.
Przykłady
<!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>Wynik
Declared role: group ARIA label: Display options Visible group text: Normal size Large size
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.