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

CKTIS / JavaScript

Ler `visibility` com `window.getComputedStyle()`

Lê o valor CSS de `visibility` resolvido pelo navegador e distingue-o da declaração presente no estilo em linha do elemento.

Versão: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxe

window.getComputedStyle(element).visibility
window.getComputedStyle(element, "::before").visibility
window.getComputedStyle(element).getPropertyValue("visibility")
element.style.visibility = "hidden"

window.getComputedStyle(element) devolve um objeto de estilos só de leitura que se atualiza automaticamente. A propriedade .visibility devolve, como cadeia de caracteres, o valor CSS resultante da cascata e da herança. getPropertyValue("visibility") lê o mesmo valor. A interface de retorno atual, CSSStyleProperties, deriva de CSSStyleDeclaration; as especificações anteriores indicavam diretamente CSSStyleDeclaration. É uma API da Web, não uma funcionalidade do ECMAScript 2024.

Omite o segundo argumento ou passa null para ler o estilo do próprio elemento. Passa uma cadeia como "::before" para ler o estilo de um pseudoelemento. O primeiro argumento tem de ser um Element; caso contrário, é lançado um TypeError. Se a análise do seletor de pseudoelemento falhar ou resultar em ::part() ou ::slotted(), o algoritmo do CSSOM devolve um objeto de estilos sem declarações em vez de lançar um TypeError. Os navegadores podem mascarar valores de :visited para proteger o histórico de navegação.

element.style.visibility lê apenas a declaração em linha e devolve "" se esta não estiver definida. Para a alterar, escreve em element.style.visibility, não no objeto devolvido por getComputedStyle(). Ao reler .visibility no mesmo objeto de estilos calculados, verás a alteração, mas uma cadeia guardada anteriormente não muda.

hidden oculta a caixa do elemento sem libertar o espaço que ocupa no layout; um descendente pode substituir o valor herdado por visible. display: none retira a caixa do layout. collapse também pode libertar espaço, por exemplo em linhas ou colunas de uma tabela; o efeito depende do tipo de elemento e do suporte do navegador. visible por si só não prova que o elemento aparece no ecrã: um antepassado pode ter display: none.

Exemplos

<!doctype html>
<html>
<head>
  <meta charset="utf-8">
  <title>Computed and inline visibility</title>
</head>
<body>
  <script>
    const parentElement = document.createElement("div");
    const child = document.createElement("span");
    parentElement.style.visibility = "hidden";
    child.textContent = "Example";
    parentElement.append(child);
    document.body.append(parentElement);

    try {
      const styles = window.getComputedStyle(child);
      console.log(JSON.stringify([child.style.visibility, styles.visibility]));

      child.style.visibility = "visible";
      console.log(JSON.stringify([child.style.visibility, styles.visibility]));
    } finally {
      parentElement.remove();
    }
  </script>
</body>
</html>

Resultado

["","hidden"]
["visible","visible"]

Guarda o exemplo num ficheiro HTML, abre-o num navegador e lê o resultado na consola de desenvolvimento. A primeira linha compara a ausência de uma declaração em linha com o valor herdado `hidden`. A segunda mostra que o mesmo objeto de estilos indica agora `visible`.

Lições relacionadas

  • JavaScript · Lição 40 · Intermédio · Versão: 3

Fontes