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

CKTIS / JavaScript

Lire `visibility` avec `window.getComputedStyle()`

Lisez la valeur CSS résolue de `visibility` et distinguez-la de la déclaration définie dans le style en ligne de l’élément.

Version : ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

window.getComputedStyle(element).visibility
window.getComputedStyle(element, "::before").visibility
window.getComputedStyle(element).getPropertyValue("visibility")
element.style.visibility = "hidden"

window.getComputedStyle(element) renvoie un objet de styles en lecture seule qui se met à jour automatiquement. Sa propriété .visibility donne, sous forme de chaîne, la valeur CSS obtenue après application de la cascade et de l’héritage. getPropertyValue("visibility") lit la même valeur. L’interface de retour actuelle, CSSStyleProperties, hérite de CSSStyleDeclaration ; les anciennes spécifications indiquaient directement CSSStyleDeclaration. C’est une API du Web, pas une fonctionnalité d’ECMAScript 2024.

Omettez le second argument ou passez null pour lire le style de l’élément lui-même. Passez une chaîne comme "::before" pour lire le style d’un pseudo-élément. Le premier argument doit être un Element ; sinon, une TypeError est levée. Si l’analyse du sélecteur de pseudo-élément échoue ou donne ::part() ou ::slotted(), l’algorithme CSSOM renvoie un objet de styles sans déclarations au lieu de lever une TypeError. Les navigateurs peuvent masquer les valeurs associées à :visited pour protéger l’historique de navigation.

element.style.visibility lit uniquement la déclaration en ligne et renvoie "" si elle est absente. Pour la modifier, utilisez element.style.visibility, et non l’objet renvoyé par getComputedStyle(). Relire .visibility sur le même objet de styles calculés reflète la modification, mais une chaîne enregistrée auparavant ne change pas.

hidden masque la boîte de l’élément sans libérer sa place dans la mise en page ; un descendant peut remplacer la valeur héritée par visible. display: none retire la boîte de la mise en page. collapse peut aussi libérer de la place, par exemple pour des lignes ou des colonnes d’un tableau ; son effet dépend du type d’élément et de la prise en charge par le navigateur. visible ne suffit pas à prouver que l’élément s’affiche : un ancêtre peut avoir display: none.

Exemples

<!doctype html>
<html>
<head>
  <meta charset="utf-8">
  <title>Computed and inline visibility</title>
</head>
<body>
  <script>
    const parentElement = document.createElement("div");
    const child = document.createElement("span");
    parentElement.style.visibility = "hidden";
    child.textContent = "Example";
    parentElement.append(child);
    document.body.append(parentElement);

    try {
      const styles = window.getComputedStyle(child);
      console.log(JSON.stringify([child.style.visibility, styles.visibility]));

      child.style.visibility = "visible";
      console.log(JSON.stringify([child.style.visibility, styles.visibility]));
    } finally {
      parentElement.remove();
    }
  </script>
</body>
</html>

Résultat

["","hidden"]
["visible","visible"]

Enregistrez l’exemple dans un fichier HTML, ouvrez-le dans un navigateur et lisez le résultat dans la console de développement. La première ligne oppose l’absence de déclaration en ligne à la valeur héritée `hidden`. La seconde montre que le même objet de styles indique désormais `visible`.

Leçons associées

  • JavaScript · Leçon 40 · Intermédiaire · Version : 3

Sources