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

CKTIS / HTML

DevTools: DOM, estilos calculados e árvore de acessibilidade

Compara o DOM atual, os valores CSS resultantes e a semântica disponibilizada às tecnologias de apoio. Verifica o papel, o nome, o estado e as relações, e experimenta uma edição temporária do DOM.

Versão: Browser DevTools workflow; UI and feature availability vary by browser and version

Sintaxe

Browser-specific DevTools workflow (not HTML syntax): Elements or Inspector → select the live DOM node; Computed → inspect its resulting CSS values; Accessibility → inspect its exposed role, accessible name, state, and relations. The HTML Living Standard defines the example’s HTML elements and hidden attribute, not the DevTools panels or how they present information.

Em Elements (Inspector no Firefox), seleciona um nó e consulta os seus atributos e texto atuais. Este é o DOM em uso, não uma cópia do ficheiro de origem: a análise do HTML e os scripts podem alterá-lo. Computed mostra os valores CSS resultantes para o nó selecionado, como display, e não a sua semântica de acessibilidade.

A árvore de acessibilidade mostra o que o navegador disponibiliza às tecnologias de apoio. Não corresponde ao DOM nó a nó. O papel indica o que é o objeto (um botão nativo tem o papel button) e o nome acessível identifica-o (neste caso, vem do texto do botão). O estado descreve a situação atual: aria-expanded indica se o painel está recolhido (false) ou expandido (true). Uma relação aponta para outro elemento: aria-controls referencia o id do painel controlado, mesmo quando este está oculto. Estes atributos ARIA não alteram por si só a visibilidade; o script atualiza hidden e mantém o estado sincronizado.

Os nomes das vistas e a apresentação das relações variam consoante o navegador. Se o painel oculto não aparecer na árvore, confirma a referência ao identificador no DOM e, depois de abrires o painel, verifica a relação se a ferramenta a mostrar. A inspeção não substitui os testes com teclado e leitor de ecrã.

Uma edição normal no inspetor só altera o DOM que está carregado. Não é guardada no ficheiro nem no servidor e perde-se ao recarregar a página normalmente. Para manter a correção, aplica-a ao código-fonte.

Exemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Inspect shipping details</title>
</head>
<body>
  <button type="button" id="toggle" aria-expanded="false" aria-controls="panel">Shipping</button>
  <section id="panel" aria-label="Shipping details" hidden style="display: none">
    <p>Ships on Monday.</p>
  </section>
  <script>
    const button = document.getElementById('toggle');
    const panel = document.getElementById('panel');

    button.addEventListener('click', () => {
      const open = panel.hidden;
      panel.style.display = open ? 'block' : 'none';
      panel.hidden = !open;
      button.setAttribute('aria-expanded', String(open));
    });
  </script>
</body>
</html>

Resultado

Initially: only Shipping is visible. The button has role button, accessible name Shipping, and a collapsed state (aria-expanded="false"). The panel is in the DOM with display: none; it is not exposed as a region.
After activating Shipping once: Ships on Monday. appears. The panel has display: block and is exposed as a region named Shipping details. The button is expanded (aria-expanded="true"); aria-controls still points to panel. How the relationship is displayed depends on the inspector.
After editing just the button's text node to Delivery: the visible label and accessible name become Delivery; the panel stays open.
After a normal reload: Shipping returns and the panel is collapsed again.

Abre o painel com `Shipping` e compara `display: none` com `display: block` para `#panel`. Altera apenas o nó de texto do botão para `Delivery`: o nome acessível muda, mas o painel fica aberto. Recarrega a página para repor `Shipping` e o estado recolhido.

Lições relacionadas

  • HTML · Lição 39 · Intermédio · Versão: 2

Fontes