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

CKTIS / JavaScript

HTMLElement.style: transform y height

Ajusta la transformación y la altura de un elemento desde JavaScript y distingue las declaraciones en línea de los valores que resuelve la cascada CSS.

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

Sintaxis

const style = element.style;
style.transform = "translateY(12px)";
style.height = "80px";
style.removeProperty("transform");
style.height = "";

HTMLElement.style devuelve un objeto que refleja en todo momento el atributo style del elemento. Si guardas una referencia, seguirá reflejando los cambios. La especificación actual devuelve CSSStyleProperties, que hereda de CSSStyleDeclaration; algunos navegadores aún pueden devolver CSSStyleDeclaration. Estas API forman parte de la plataforma web, no de ECMAScript 2024.

No puedes sustituir el objeto: asignar directamente a element.style establece cssText y reemplaza el bloque de declaraciones. Usa element.style.transform y element.style.height para leer o cambiar declaraciones individuales. Asigna cadenas CSS válidas, como "80px". En el modo estándar, si asignas a height un valor distinto de cero y sin unidad, como "81", la asignación se ignora sin lanzar una excepción y el valor anterior queda intacto. En el modo de compatibilidad (quirks mode), los navegadores pueden interpretar ese valor como una longitud en píxeles.

transform cambia cómo se dibuja una caja transformable: translateY(12px) la desplaza 12 píxeles CSS hacia abajo sin cambiar el espacio que ocupa en el flujo normal. height especifica una altura para la maquetación: por defecto dimensiona la caja de contenido; con box-sizing: border-box, la caja de borde.

Leer una declaración en línea ausente devuelve "". Asignar "" o llamar a removeProperty() elimina esa declaración; no equivale a establecer transform: none o height: auto. Para leer los valores resueltos tras la cascada, usa el objeto de solo lectura que devuelve getComputedStyle(element).

Ejemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>HTMLElement.style: transform and height</title>
</head>
<body>
<script>
(() => {
  const element = document.createElement("div");
  const style = element.style;
  const log = () => console.log(JSON.stringify([style.transform, style.height]));

  style.transform = "translateY(12px)";
  style.height = "80px";
  log();

  style.height = "81";
  log();

  style.removeProperty("height");
  log();
})();
</script>
</body>
</html>

Resultado

["translateY(12px)","80px"]
["translateY(12px)","80px"]
["translateY(12px)",""]

Guarda el ejemplo completo en un archivo HTML y ábrelo en un navegador. Conserva `<!doctype html>` para que la página se procese en el modo estándar. Comprueba la salida en la consola del navegador. El elemento no se añade al documento, por lo que la salida muestra declaraciones en línea, no dimensiones en pantalla.

Lecciones relacionadas

  • JavaScript · Lección 11 · Avanzado · Versión: 4

Fuentes