Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

CSSStyleDeclaration.visibility : valeurs déclarées et calculées

Lis le résultat de la cascade CSS avec getComputedStyle(element).visibility plutôt qu’avec element.style.visibility. Distingue les déclarations en ligne, l’héritage et l’objet de style dynamique.

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

Syntaxe

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

CSSStyleDeclaration.visibility désigne l’accès nommé à la propriété CSS visibility, et non une méthode de calcul distincte. La documentation moderne rattache ces propriétés à CSSStyleProperties, dérivé de CSSStyleDeclaration ; les anciennes implémentations utilisent le type de base.

element.style.visibility ne lit que la déclaration en ligne : il peut renvoyer "" ou "inherit". window.getComputedStyle(element).visibility renvoie la valeur résolue après prise en compte de la cascade et de l’héritage. En général, une valeur résolue n’est pas toujours identique à une valeur calculée. Lire getPropertyValue("visibility") sur l’objet renvoyé est équivalent.

visibility est héritée. hidden masque un élément tout en conservant son espace dans la mise en page ; display: none supprime cet espace. Un élément descendant peut définir explicitement visible. collapse a un comportement particulier, notamment dans les tableaux, et présente des limites selon les navigateurs. La valeur visible à elle seule ne prouve pas que l’élément est réellement visible.

L’objet renvoyé par getComputedStyle() est en lecture seule et dynamique : il est actualisé lorsque les styles changent. Modifie element.style ou les règles CSS, pas cet objet. Il s’agit d’une API de navigateur, et non d’une fonctionnalité d’une édition particulière d’ECMAScript ; Node 24 ne permet pas d’établir sa disponibilité. La lecture de base est largement prise en charge, indépendamment du nom plus récent de l’interface.

Exemples

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

Résultat

"inherit"
hidden
visible

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources