Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes