Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

CSSStyleDeclaration.visibility: deklaracja a wartość obliczona

Odczytuj wynik kaskady CSS przez getComputedStyle(element).visibility, a nie przez element.style.visibility. Rozróżniaj deklaracje inline, dziedziczenie i odczytywany na bieżąco obiekt stylu.

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

Składnia

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

CSSStyleDeclaration.visibility oznacza nazwany dostęp do właściwości CSS visibility, a nie osobną metodę obliczeniową. Współczesna dokumentacja umieszcza takie właściwości w CSSStyleProperties, pochodnym od CSSStyleDeclaration; starsze implementacje używają typu bazowego.

element.style.visibility odczytuje wyłącznie deklarację inline: może zwrócić "" lub "inherit". window.getComputedStyle(element).visibility zwraca wartość rozstrzygniętą po uwzględnieniu kaskady i dziedziczenia. Ogólnie wartość rozstrzygnięta nie zawsze jest tym samym co wartość obliczona. Równoważny odczyt to getPropertyValue("visibility") na zwróconym obiekcie.

visibility jest dziedziczona. hidden ukrywa element, zachowując jego miejsce w układzie; display: none usuwa je z układu. Potomek może jawnie ustawić visible. collapse ma specjalne znaczenie m.in. w tabelach i ograniczenia zgodności między przeglądarkami. Sam wynik visible nie dowodzi, że element rzeczywiście widać.

Obiekt zwrócony przez getComputedStyle() jest tylko do odczytu i aktualizuje się wraz ze zmianami stylu. Zmieniaj element.style lub reguły CSS, nie ten obiekt. To API przeglądarki, nie funkcja określonej edycji ECMAScript; Node 24 nie potwierdza jego dostępności. Podstawowy odczyt jest szeroko obsługiwany, niezależnie od nowszej nazwy interfejsu.

Przykłady

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

Wynik

"inherit"
hidden
visible

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła