Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

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

Lee el valor CSS de `visibility` resuelto por el navegador y distínguelo de la declaración escrita en el estilo en línea del elemento.

Versión: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxis

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

window.getComputedStyle(element) devuelve un objeto de estilos de solo lectura que se actualiza automáticamente. Su propiedad .visibility devuelve como cadena el valor CSS tras aplicar la cascada y la herencia. getPropertyValue("visibility") lee el mismo valor. La interfaz de retorno actual, CSSStyleProperties, hereda de CSSStyleDeclaration; las especificaciones anteriores indicaban directamente CSSStyleDeclaration. Es una API web, no una función de ECMAScript 2024.

Omite el segundo argumento o pasa null para consultar el estilo del propio elemento. Pasa una cadena como "::before" para consultar el estilo de un pseudoelemento. El primer argumento debe ser un Element; de lo contrario, se lanza un TypeError. Si el análisis del selector de pseudoelemento falla o da como resultado ::part() o ::slotted(), el algoritmo de CSSOM devuelve un objeto de estilos sin declaraciones en lugar de lanzar un TypeError. Los navegadores pueden enmascarar los estilos de :visited para proteger el historial de navegación.

element.style.visibility lee solo la declaración en línea y devuelve "" si no existe. Para cambiarla, escribe en element.style.visibility, no en el objeto devuelto por getComputedStyle(). Si vuelves a leer .visibility en el mismo objeto de estilos calculados, verás el cambio, pero una cadena guardada antes no cambiará.

hidden oculta la caja del elemento, pero conserva su espacio en la disposición; un descendiente puede sustituir el valor heredado por visible. display: none retira la caja de la disposición. collapse también puede liberar espacio, por ejemplo en filas o columnas de una tabla; su efecto depende del tipo de elemento y de la compatibilidad del navegador. visible no basta para saber si el elemento se muestra en pantalla: un antepasado podría tener display: none.

Ejemplos

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

Resultado

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

Guarda el ejemplo como archivo HTML, ábrelo en un navegador y lee el resultado en la consola de desarrollo. La primera línea contrapone la ausencia de declaración en línea al valor heredado `hidden`. La segunda muestra que el mismo objeto de estilos devuelve ahora `visible`.

Lecciones relacionadas

  • JavaScript · Lección 40 · Intermedio · Versión: 3

Fuentes