Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Leggere `visibility` con `window.getComputedStyle()`

Leggi il valore CSS risolto di `visibility` e distinguilo dalla dichiarazione presente nello stile in linea dell’elemento.

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

Sintassi

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

window.getComputedStyle(element) restituisce un oggetto di stile in sola lettura che si aggiorna automaticamente. La sua proprietà .visibility restituisce come stringa il valore CSS risultante dalla cascata e dall’ereditarietà. getPropertyValue("visibility") legge lo stesso valore. L’interfaccia restituita oggi, CSSStyleProperties, deriva da CSSStyleDeclaration; le specifiche precedenti indicavano direttamente CSSStyleDeclaration. È un’API web, non una funzionalità di ECMAScript 2024.

Ometti il secondo argomento o passa null per leggere lo stile dell’elemento stesso. Passa una stringa come "::before" per leggere lo stile di uno pseudo-elemento. Il primo argomento deve essere un Element; in caso contrario viene generato un TypeError. Se l’analisi del selettore di pseudo-elemento fallisce o restituisce ::part() o ::slotted(), l’algoritmo CSSOM restituisce un oggetto di stile senza dichiarazioni anziché generare un TypeError. I browser possono mascherare gli stili di :visited per proteggere la cronologia di navigazione.

element.style.visibility legge solo la dichiarazione in linea e restituisce "" se non è impostata. Per modificarla, scrivi in element.style.visibility, non nell’oggetto restituito da getComputedStyle(). Rileggendo .visibility sullo stesso oggetto degli stili calcolati vedrai la modifica, ma una stringa salvata in precedenza non cambia.

hidden nasconde il riquadro dell’elemento senza liberare lo spazio che occupa nel layout; un discendente può sostituire il valore ereditato con visible. display: none rimuove il riquadro dal layout. Anche collapse può liberare spazio, ad esempio per righe o colonne di una tabella; l’effetto dipende dal tipo di elemento e dal supporto del browser. visible da solo non garantisce che l’elemento appaia sullo schermo: un antenato potrebbe avere display: none.

Esempi

<!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>

Risultato

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

Salva l’esempio come file HTML, aprilo in un browser e leggi il risultato nella console per sviluppatori. La prima riga contrappone l’assenza di una dichiarazione in linea al valore ereditato `hidden`. La seconda mostra che lo stesso oggetto di stile ora riporta `visible`.

Lezioni correlate

  • JavaScript · Lezione 40 · Intermedio · Versione: 3

Fonti