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.