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

CKTIS / JavaScript

CSSStyleDeclaration.visibility: valores declarados y calculados

Lee el resultado de la cascada CSS mediante getComputedStyle(element).visibility, no con element.style.visibility. Distingue las declaraciones en línea, la herencia y el objeto de estilo dinámico.

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

Sintaxis

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

CSSStyleDeclaration.visibility designa el acceso con nombre a la propiedad CSS visibility, no un método de cálculo independiente. La documentación moderna sitúa estas propiedades en CSSStyleProperties, derivado de CSSStyleDeclaration; las implementaciones antiguas usan el tipo base.

element.style.visibility solo lee la declaración en línea: puede devolver "" o "inherit". window.getComputedStyle(element).visibility devuelve el valor resuelto tras tener en cuenta la cascada y la herencia. En general, un valor resuelto no siempre es lo mismo que un valor calculado. Leer getPropertyValue("visibility") en el objeto devuelto es equivalente.

visibility se hereda. hidden oculta un elemento y conserva su espacio en el diseño; display: none elimina ese espacio. Un elemento descendiente puede establecer explícitamente visible. collapse tiene un comportamiento especial, entre otros casos en las tablas, y presenta limitaciones entre navegadores. El valor visible por sí solo no demuestra que el elemento sea realmente visible.

El objeto devuelto por getComputedStyle() es de solo lectura y dinámico: se actualiza cuando cambian los estilos. Modifica element.style o las reglas CSS, no este objeto. Es una API del navegador, no una característica de una edición concreta de ECMAScript; Node 24 no demuestra que esté disponible allí. La lectura básica cuenta con amplia compatibilidad, independientemente del nombre más reciente de la interfaz.

Ejemplos

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

Resultado

"inherit"
hidden
visible

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes