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