WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

CSSStyleDeclaration.visibility: deklarierte und berechnete Werte

Lies das Ergebnis der CSS-Kaskade mit getComputedStyle(element).visibility statt mit element.style.visibility aus. Unterscheide zwischen Inline-Deklarationen, Vererbung und dem dynamischen Stilobjekt.

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

Syntax

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

CSSStyleDeclaration.visibility bezeichnet den benannten Zugriff auf die CSS-Eigenschaft visibility, nicht eine separate Berechnungsmethode. In der modernen Dokumentation sind solche Eigenschaften CSSStyleProperties zugeordnet, das von CSSStyleDeclaration abgeleitet ist; ältere Implementierungen verwenden den Basistyp.

element.style.visibility liest nur die Inline-Deklaration aus und kann "" oder "inherit" zurückgeben. window.getComputedStyle(element).visibility liefert den aufgelösten Wert nach Berücksichtigung der Kaskade und Vererbung. Ein aufgelöster Wert ist nicht immer dasselbe wie ein berechneter Wert. Ein gleichwertiger Lesezugriff ist getPropertyValue("visibility") auf dem zurückgegebenen Objekt.

visibility wird vererbt. hidden blendet ein Element aus, lässt aber seinen Platz im Layout bestehen; display: none entfernt diesen Platz. Ein Nachfahre kann ausdrücklich visible festlegen. collapse hat unter anderem in Tabellen eine besondere Wirkung und weist browserübergreifende Einschränkungen auf. Der Wert visible allein beweist nicht, dass das Element tatsächlich sichtbar ist.

Das von getComputedStyle() zurückgegebene Objekt ist schreibgeschützt und dynamisch: Es wird bei Stiländerungen aktualisiert. Ändere element.style oder CSS-Regeln, nicht dieses Objekt. Dies ist eine Browser-API und keine Funktion einer bestimmten ECMAScript-Ausgabe; Node 24 belegt nicht, dass sie dort verfügbar ist. Das grundlegende Auslesen wird breit unterstützt, unabhängig vom neueren Namen der Schnittstelle.

Beispiele

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

Ergebnis

"inherit"
hidden
visible

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen