CKTIS / HTML
role — il ruolo di accessibilità di un elemento
L’attributo `role` indica alle tecnologie assistive il ruolo semantico di un elemento. Non aggiunge aspetto né comportamento. Usalo secondo le regole ARIA in HTML e preferisci gli elementi che forniscono già la semantica nativa appropriata.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
role="role-name [fallback-role-name ...]"L’attributo role comunica alle tecnologie assistive il tipo di un elemento, per esempio un gruppo o un pulsante. Riguarda la semantica nell’albero di accessibilità, non l’aspetto. Non sostituisce un nome accessibile: nell’esempio, group definisce il ruolo e aria-label fornisce il nome Display options.
Il valore può contenere nomi di ruolo separati da caratteri di spaziatura. Per determinare il ruolo, il browser usa il primo nome riconosciuto che corrisponde a un ruolo non astratto. L’elenco fornisce ruoli di ripiego, non più ruoli simultanei. Il ruolo così selezionato non è necessariamente quello esposto nell’albero di accessibilità. Per esempio, per un button che può ricevere il focus, il browser deve ignorare none o presentation ed esporre invece il ruolo implicito di pulsante. I ruoli astratti non devono essere usati nei contenuti di una pagina.
Preferisci un elemento HTML nativo con la semantica appropriata. button ha già il ruolo di pulsante, quindi ripeterlo è ridondante. Le sostituzioni consentite dipendono dall’elemento e dalle regole ARIA in HTML; non tutti i ruoli sono validi ovunque. Rispetta anche i requisiti del ruolo scelto riguardo a nomi, stati e struttura.
Aggiungere solo role="button" non introduce la gestione della tastiera, la possibilità di ricevere il focus né azioni. L’esempio raggruppa due pulsanti di opzione nativi (<input type="radio">) senza sostituirne i ruoli. Quando cambia l’opzione selezionata, lo script modifica la dimensione del carattere del testo di esempio. output riporta ciò che viene scritto nella console: i valori dichiarati di role e aria-label e il testo visibile del gruppo. Non è un’ispezione dell’albero di accessibilità.
Esempi
<!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>Risultato
Declared role: group ARIA label: Display options Visible group text: Normal size Large size
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.