База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

CSSStyleDeclaration.visibility: декларирани и изчислени стойности

Прочетете резултата от CSS каскадата чрез getComputedStyle(element).visibility, а не чрез element.style.visibility. Разграничавайте вградените декларации, наследяването и живия обект със стилове.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

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

CSSStyleDeclaration.visibility обозначава достъп по име до CSS свойството visibility, а не отделен метод за изчисляване. Съвременната документация поставя тези свойства в CSSStyleProperties, наследник на CSSStyleDeclaration; по-старите реализации използват базовия тип.

element.style.visibility чете само вградената декларация: може да върне "" или "inherit". window.getComputedStyle(element).visibility връща разрешената стойност след отчитане на каскадата и наследяването. По принцип разрешената стойност невинаги е същото като изчислената стойност. Еквивалентно е да се прочете getPropertyValue("visibility") от върнатия обект.

visibility се наследява. hidden скрива елемент, като запазва мястото му в оформлението; display: none премахва това място. Потомък може изрично да зададе visible. collapse има специално поведение, включително в таблици, и ограничения при различните браузъри. Самата стойност visible не доказва, че елементът действително се вижда.

Обектът, върнат от getComputedStyle(), е само за четене и динамичен: актуализира се при промяна на стиловете. Променяйте element.style или CSS правилата, а не този обект. Това е API на браузъра, а не функция на конкретно издание на ECMAScript; Node 24 не доказва наличието му. Основното прочитане се поддържа широко независимо от по-новото име на интерфейса.

Примери

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

Резултат

"inherit"
hidden
visible

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници