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

CKTIS / JavaScript

CSSStyleDeclaration.visibility: valores declarados e calculados

Lê o resultado da cascata CSS através de getComputedStyle(element).visibility, em vez de element.style.visibility. Distingue declarações inline, herança e o objeto de estilo dinâmico.

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.style.visibility = "hidden";
window.getComputedStyle(element).visibility;
window.getComputedStyle(element).getPropertyValue("visibility");

CSSStyleDeclaration.visibility designa o acesso nomeado à propriedade CSS visibility, não um método de cálculo separado. A documentação moderna associa estas propriedades a CSSStyleProperties, derivado de CSSStyleDeclaration; as implementações mais antigas usam o tipo base.

element.style.visibility lê apenas a declaração inline: pode devolver "" ou "inherit". window.getComputedStyle(element).visibility devolve o valor resolvido depois de considerar a cascata e a herança. Em geral, um valor resolvido nem sempre é o mesmo que um valor calculado. Ler getPropertyValue("visibility") no objeto devolvido é equivalente.

visibility é herdada. hidden oculta um elemento, mantendo o seu espaço no esquema da página; display: none remove esse espaço. Um elemento descendente pode definir explicitamente visible. collapse tem um comportamento especial, nomeadamente em tabelas, e apresenta limitações entre navegadores. O valor visible, por si só, não prova que o elemento esteja realmente visível.

O objeto devolvido por getComputedStyle() é só de leitura e dinâmico: é atualizado quando os estilos mudam. Altera element.style ou as regras CSS, não este objeto. Trata-se de uma API do navegador, não de uma funcionalidade de uma edição específica de ECMAScript; o Node 24 não comprova a sua disponibilidade. A leitura básica é amplamente suportada, independentemente do nome mais recente da interface.

Exemplos

const parent = document.createElement("div");
const child = document.createElement("span");
parent.style.visibility = "hidden";
child.style.visibility = "inherit";
parent.append(child);
document.body.append(parent);

try {
  const computed = window.getComputedStyle(child);
  console.log(JSON.stringify(child.style.visibility));
  console.log(computed.visibility);
  child.style.visibility = "visible";
  console.log(computed.getPropertyValue("visibility"));
} finally {
  parent.remove();
}

Resultado

"inherit"
hidden
visible

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes