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.