KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

CSSStyleDeclaration.visibility: gedeclareerde en berekende waarden

Lees het resultaat van de CSS-cascade met getComputedStyle(element).visibility in plaats van met element.style.visibility. Maak onderscheid tussen inline declaraties, overerving en het dynamische stijlobject.

Versie: 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 staat voor benoemde toegang tot de CSS-eigenschap visibility, niet voor een afzonderlijke berekeningsmethode. Moderne documentatie plaatst deze eigenschappen op CSSStyleProperties, dat is afgeleid van CSSStyleDeclaration; oudere implementaties gebruiken het basistype.

element.style.visibility leest alleen de inline declaratie en kan "" of "inherit" teruggeven. window.getComputedStyle(element).visibility geeft de opgeloste waarde na verwerking van de cascade en overerving. Een opgeloste waarde is over het algemeen niet altijd hetzelfde als een berekende waarde. getPropertyValue("visibility") aanroepen op het teruggegeven object levert een gelijkwaardige uitlezing op.

visibility wordt overgeërfd. hidden verbergt een element zonder de ruimte ervan in de layout weg te nemen; display: none verwijdert die ruimte wel. Een afstammeling kan expliciet visible instellen. collapse heeft onder andere in tabellen een speciale werking en kent beperkingen tussen browsers. De waarde visible bewijst op zichzelf niet dat het element daadwerkelijk zichtbaar is.

Het object dat getComputedStyle() teruggeeft, is alleen-lezen en dynamisch: het wordt bijgewerkt wanneer stijlen veranderen. Wijzig element.style of CSS-regels, niet dit object. Dit is een browser-API, geen functie van een bepaalde ECMAScript-editie; Node 24 toont niet aan dat de API daar beschikbaar is. De basisuitlezing wordt breed ondersteund, los van de nieuwere interfacenaam.

Voorbeelden

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

Resultaat

"inherit"
hidden
visible

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen