CKTIS / JavaScript
Interações acessíveis em JavaScript
Uma interação acessível combina utilização pelo teclado, foco previsível e um estado compreensível pelas tecnologias de apoio. O JavaScript deve sincronizar a visibilidade com ARIA e comunicar atualizações sem deslocar o foco desnecessariamente.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
element.setAttribute('aria-expanded', String(expanded));
panel.hidden = !expanded;
trigger.focus();
status.textContent = message;Uma interação acessível permite utilizar uma interface sem rato e compreender as respetivas alterações com a ajuda de tecnologias de apoio. Comece por botões nativos: fornecem semântica e ativação pelo teclado. ARIA descreve a interface, mas não acrescenta comportamento por si só. A especificação ECMAScript descreve a linguagem e distingue-a do respetivo ambiente anfitrião; a fonte fornecida não define DOM, HTML nem ARIA.
A gestão do estado ARIA e do foco do teclado consiste em sincronizar o estado, a visibilidade e o foco. No exemplo, aria-expanded corresponde ao inverso de panel.hidden, enquanto aria-controls identifica panel. No teste de abertura, o foco já está no botão Details e permanece aí; o painel não é uma caixa de diálogo modal. A função que trata a ativação de Close details coloca o foco em Details antes de ocultar o painel. Quando Details fecha o painel, se o foco ainda estiver dentro do painel, setExpanded devolve-o a Details antes de ocultar o painel. O teste na consola abrange as duas formas de fechar o painel, incluindo a ativação de Details sem primeiro deslocar o foco para esse botão. Não remova o indicador de foco visível nem utilize valores positivos de tabindex para corrigir a ordem de navegação.
Os anúncios das regiões dinâmicas ARIA comunicam atualizações sem deslocar o foco. O exemplo atualiza textContent numa região existente com role="status". Este papel confere implicitamente o comportamento de aria-live="polite"; o código HTML não define um atributo aria-live. O atributo aria-atomic="true" indica que todo o conteúdo da região deve ser tratado como a mensagem. A região existe antes da atualização. Não a utilize em vez dos rótulos dos controlos nem anuncie todas as pequenas alterações. As palavras exatas e o momento do anúncio dependem do navegador e da tecnologia de apoio.
Guarde o exemplo como ficheiro HTML e verifique a utilização do teclado, os valores dos atributos e os anúncios do leitor de ecrã. O resultado esperado descreve o estado do DOM e a posição do foco, mas não garante o que o leitor de ecrã irá dizer. O exemplo foi executado num ambiente isolado com Chromium e a saída da consola correspondeu exatamente à esperada. Utiliza sintaxe ECMAScript 2015 e interfaces do navegador; o suporte no ambiente de destino tem de ser verificado separadamente. O Node 24 no repositório não comprova o suporte dessas interfaces.
Exemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Accessible disclosure</title>
</head>
<body>
<button id="toggle" type="button" aria-expanded="false" aria-controls="panel">Details</button>
<section id="panel" aria-label="Details" hidden>
<p>Additional information.</p>
<button id="close" type="button">Close details</button>
</section>
<p id="status" role="status" aria-atomic="true"></p>
<script>
const toggle = document.getElementById('toggle');
const panel = document.getElementById('panel');
const closeButton = document.getElementById('close');
const statusMessage = document.getElementById('status');
function setExpanded(expanded) {
if (!expanded && panel.contains(document.activeElement)) {
toggle.focus();
}
panel.hidden = !expanded;
toggle.setAttribute('aria-expanded', String(expanded));
statusMessage.textContent = expanded ? 'Details opened.' : 'Details closed.';
}
toggle.addEventListener('click', () => setExpanded(panel.hidden));
closeButton.addEventListener('click', () => {
toggle.focus();
setExpanded(false);
});
function report(step) {
console.log(`${step}: hidden=${panel.hidden}; aria-expanded=${toggle.getAttribute('aria-expanded')}; status=${JSON.stringify(statusMessage.textContent)}`);
}
report('Initial');
toggle.focus();
toggle.click();
report('Open');
console.log('Open kept focus on Details: ' + (document.activeElement === toggle));
// Test closing when activation does not first focus the close button.
toggle.blur();
console.log('Focus inside panel before close: ' + panel.contains(document.activeElement));
closeButton.click();
report('Close');
console.log('Focus returned to Details: ' + (document.activeElement === toggle));
// Test closing with Details while focus remains inside the panel.
toggle.click();
closeButton.focus();
console.log('Focus inside panel before closing with Details: ' + panel.contains(document.activeElement));
toggle.click();
report('Close with Details');
console.log('Focus returned to Details: ' + (document.activeElement === toggle));
</script>
</body>
</html>Resultado
Initial: hidden=true; aria-expanded=false; status="" Open: hidden=false; aria-expanded=true; status="Details opened." Open kept focus on Details: true Focus inside panel before close: false Close: hidden=true; aria-expanded=false; status="Details closed." Focus returned to Details: true Focus inside panel before closing with Details: true Close with Details: hidden=true; aria-expanded=false; status="Details closed." Focus returned to Details: true
O teste ativa `Details` por código enquanto o foco está em `Close details`. O foco deve voltar a `Details` antes de o painel ser ocultado.