CKTIS / HTML
role — o papel de acessibilidade de um elemento
O atributo `role` indica às tecnologias de assistência o papel semântico de um elemento. Não acrescenta aspeto nem comportamento. Utilize-o de acordo com as regras de ARIA in HTML e prefira elementos que já forneçam a semântica nativa adequada.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
role="role-name [fallback-role-name ...]"O atributo role comunica às tecnologias de assistência o tipo de um elemento, como um grupo ou um botão. Diz respeito à semântica na árvore de acessibilidade, não ao aspeto. Não substitui um nome acessível: no exemplo, group define o papel e aria-label fornece o nome Display options.
O valor pode conter nomes de papéis separados por espaços em branco. Para determinar o papel, o navegador utiliza o primeiro nome reconhecido que corresponde a um papel não abstrato. A lista fornece papéis alternativos, não vários papéis simultâneos. O papel assim selecionado não é necessariamente o que fica exposto na árvore de acessibilidade. Por exemplo, num button que pode receber o foco, o navegador tem de ignorar none ou presentation e expor, em vez disso, o papel implícito de botão. Os papéis abstratos não devem ser utilizados no conteúdo de uma página.
Prefira um elemento HTML nativo com a semântica adequada. button já tem o papel de botão, pelo que repeti-lo é redundante. As substituições permitidas dependem do elemento e das regras de ARIA in HTML; nem todos os papéis são válidos em todo o lado. Cumpra também os requisitos do papel escolhido relativos a nomes, estados e estrutura.
Adicionar apenas role="button" não acrescenta suporte para teclado, capacidade de receber foco nem ações. O exemplo agrupa dois botões de opção nativos (<input type="radio">) sem substituir os respetivos papéis. Quando a opção selecionada muda, o script altera o tamanho da letra do texto de exemplo. output apresenta o que é registado na consola: os valores declarados de role e aria-label e o texto visível do grupo. Não é uma inspeção da árvore de acessibilidade.
Exemplos
<!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>Resultado
Declared role: group ARIA label: Display options Visible group text: Normal size Large size
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.