Acessibilidade no DOM: WAI-ARIA, Roles, Live Regions e Gerenciamento de Foco
A Web foi concebida por Tim Berners-Lee com um princípio inegociável: ser universalmente acessível a qualquer ser humano, independentemente de hardware, software, idioma, localização ou capacidade física e cognitiva. No entanto, interfaces ricas construídas com mutações dinâmicas de JavaScript frequentemente se tornam invisíveis ou incompreensíveis para usuários que dependem de tecnologias assistivas (como leitores de tela NVDA, VoiceOver e JAWS).
Inaugurando o Módulo 6: Estado, Reatividade, Acessibilidade & Projetos Finais, esta lição aprofundada examina a Árvore de Acessibilidade (Accessibility Tree) mantida em paralelo pelo navegador. Você compreenderá a Primeira Regra de Ouro do W3C WAI-ARIA, dominará a manipulação programática de atributos de estado (aria-expanded, aria-selected, aria-hidden), aprenderá a utilizar Live Regions (aria-live) para anunciar atualizações dinâmicas e implementará um gerenciamento profissional de foco com tabindex="-1" e restauração de foco.
📑 Índice do Conteúdo
1. A Primeira Regra do WAI-ARIA e a Árvore de Acessibilidade
O navegador compila o HTML em duas estruturas simultâneas: a Árvore DOM (para renderização e scripts) e a Árvore de Acessibilidade (que traduz o significado semântico para as APIs do sistema operacional, como UI Automation no Windows ou NSAccessibility no macOS).
A Primeira Regra do W3C ARIA: “Se você puder usar um elemento ou atributo HTML nativo com a semântica e o comportamento já embutidos, faça-o em vez de reinventar o elemento com ARIA.”
Nunca use
<div role="button" tabindex="0">se você puder usar um simples<button>nativo!
2. Atributos de Estado e Relações Semânticas
Quando componentes dinâmicos mudam de estado via JavaScript, você deve atualizar os atributos ARIA correspondentes no DOM:
const botaoMenu = document.querySelector('#btn-menu-drawer');
const menuDrawer = document.querySelector('#drawer');
botaoMenu.addEventListener('click', () => {
const isAberto = botaoMenu.getAttribute('aria-expanded') === 'true';
// 1. Inverte o estado de expansão acessível
botaoMenu.setAttribute('aria-expanded', String(!isAberto));
// 2. Controla a visibilidade acessível da gaveta
menuDrawer.setAttribute('aria-hidden', String(isAberto));
menuDrawer.classList.toggle('is-open', !isAberto);
});
aria-labelledby="id-elemento": Aponta para outro elemento que serve de título/rótulo (superior a usartitle).aria-describedby="id-elemento": Aponta para o parágrafo de ajuda ou mensagem de erro que descreve o campo.aria-controls="id-elemento": Identifica qual nó do DOM é controlado ou afetado por este botão.
3. Live Regions: Notificações em Tempo Real com `aria-live`
Quando um carrinho de compras é atualizado via AJAX ou uma mensagem de toast surge na tela, um usuário com visão enxerga a novidade imediatamente. Já um usuário cego não tem como saber que algo mudou, a menos que a área esteja marcada como uma Live Region:
| Configuração | Comportamento do Leitor de Tela | Caso de Uso Recomendado |
|---|---|---|
aria-live="polite" |
Aguarda o leitor terminar de falar a frase atual antes de anunciar a nova mensagem. | Notificações gerais, itens adicionados ao carrinho, resultados de busca paginados. |
aria-live="assertive" |
Interrompe imediatamente qualquer áudio em andamento para ler o alerta. | Erros críticos de sistema, mensagens de sessão expirando, falhas de pagamento. |
aria-atomic="true" |
Lê a região inteira como um todo, em vez de ler apenas a palavra que sofreu mutação. | Badges de contador (ex: “5 itens no carrinho” em vez de apenas dizer “5”). |
4. Gerenciamento Profissional de Foco
Mover o foco programaticamente é essencial ao abrir caixas de diálogo, mudar de etapas em assistentes (wizards) ou notificar erros de validação:
• tabindex="0": Insere um elemento não focável (como ) na ordem natural de navegação via teclado (Tab).
• tabindex="-1": Permite que o elemento receba foco VIA JAVASCRIPT (element.focus()), mas NÃO via tecla Tab.
• tabindex="1+": ANTI-PATTERN SEVERO! Quebra a ordem natural de tabulação da página. Nunca utilize!
Padrão de Restauração de Foco
Antes de mover o foco para um modal ou painel dinâmico, armazene sempre o elemento ativo anterior em uma variável para devolvê-lo quando o usuário concluir a ação:
let elementoOrigemFoco = null;
function abrirDialogo(dialogo) {
elementoOrigemFoco = document.activeElement; // Salva o botão que o usuário clicou
dialogo.classList.add('is-open');
dialogo.querySelector('.primeiro-campo').focus({ preventScroll: true });
}
function fecharDialogo(dialogo) {
dialogo.classList.remove('is-open');
if (elementoOrigemFoco) {
elementoOrigemFoco.focus(); // Restaura o foco com precisão!
}
}
5. Laboratório Interativo no Playground IDE
No laboratório prático desta lição, você operará um Sistema de Abas Acessíveis (W3C Tabs Pattern) completo: construído com role="tablist", role="tab" e role="tabpanel", com suporte a navegação por teclado pelas setas (ArrowLeft e ArrowRight) e alternância de aria-selected. Você também operará uma Live Region ativa (com aria-live="polite" e aria-atomic="true") que exibe uma transcrição em tempo real do que um leitor de tela falaria audivelmente para o usuário.
Aplique o que você aprendeu nesta lição
Utilize nossas ferramentas online gratuitas para experimentar os conceitos ou teste o código ao vivo no Playground IDE.
Editor de Códigos Web Online
Ambiente com destaque de sintaxe para você testar tags, tabelas e scripts na hora.
Abrir Ferramenta OnlinePlayground Web Online
Escreva seu código HTML, CSS ou JavaScript e veja o resultado renderizado ao vivo no navegador com zero configuração.
⚡ Codificar no Playground IDE