Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

CSSStyleDeclaration.visibility: valori dichiarati e calcolati

Leggi il risultato della cascata CSS con getComputedStyle(element).visibility, non con element.style.visibility. Distingui le dichiarazioni inline, l’ereditarietà e l’oggetto di stile dinamico.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

element.style.visibility = "hidden";
window.getComputedStyle(element).visibility;
window.getComputedStyle(element).getPropertyValue("visibility");

CSSStyleDeclaration.visibility indica l’accesso con nome alla proprietà CSS visibility, non un metodo di calcolo separato. La documentazione moderna colloca queste proprietà in CSSStyleProperties, derivato da CSSStyleDeclaration; le implementazioni meno recenti usano il tipo base.

element.style.visibility legge solo la dichiarazione inline: può restituire "" oppure "inherit". window.getComputedStyle(element).visibility restituisce il valore risolto dopo aver considerato cascata ed ereditarietà. In generale, un valore risolto non coincide sempre con un valore calcolato. Leggere getPropertyValue("visibility") sull’oggetto restituito è equivalente.

visibility è ereditata. hidden nasconde un elemento mantenendo il suo spazio nel layout; display: none rimuove quello spazio. Un elemento discendente può impostare esplicitamente visible. collapse ha un comportamento speciale, per esempio nelle tabelle, e presenta limitazioni tra browser. Il valore visible, da solo, non dimostra che l’elemento sia effettivamente visibile.

L’oggetto restituito da getComputedStyle() è di sola lettura e dinamico: si aggiorna quando cambiano gli stili. Modifica element.style o le regole CSS, non questo oggetto. È un’API del browser, non una funzionalità di una particolare edizione di ECMAScript; Node 24 non ne dimostra la disponibilità. La lettura di base è ampiamente supportata, indipendentemente dal nome più recente dell’interfaccia.

Esempi

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();
}

Risultato

"inherit"
hidden
visible

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti