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

CKTIS / JavaScript

Anchura y altura en CSS en línea: `style.width` y `style.height`

Usa `element.style.width` y `element.style.height` para leer, establecer y eliminar declaraciones CSS en línea. Leer una declaración no equivale a medir el elemento.

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

Sintaxis

element.style.width
 element.style.height
 element.style.width = cssWidth
 element.style.height = cssHeight
 element.style.width = ""
 element.style.height = ""

element.style.width y element.style.height leen y modifican declaraciones CSS en el atributo style de un elemento HTML, no sus atributos HTML width y height. element.style devuelve un objeto de declaraciones que refleja los cambios en directo, no una copia fija. Cada propiedad devuelve texto CSS o "" si no hay declaración en línea, aunque una hoja de estilos aporte un valor.

Asigna cadenas como "120px", "50%" o "auto". Incluye px si quieres expresar un tamaño en píxeles: la API no añade unidades a los números. Un valor no válido como "invalid" deja intacta la declaración anterior. "" elimina la declaración en línea y deja que la cascada determine el valor; "auto", en cambio, establece una declaración.

Una declaración en línea no garantiza el tamaño final. La cascada, la disposición y restricciones como max-width pueden influir en él. Estas propiedades no se aplican a elementos en línea no reemplazados, como un span normal. box-sizing determina si el tamaño se refiere a la caja de contenido (content-box) o incluye también el relleno y los bordes (border-box).

Si el elemento participa en la disposición, lee getComputedStyle(element).width o .height para obtener el valor CSS resuelto como texto. Si necesitas las dimensiones del rectángulo delimitador en píxeles CSS, llama a element.getBoundingClientRect() y lee sus valores numéricos width y height. El rectángulo incluye el relleno y los bordes y tiene en cuenta las transformaciones CSS. Son API del navegador, no forman parte de ECMAScript 2024 y requieren un entorno con DOM.

Ejemplos

<!doctype html>
<meta charset="utf-8">
<title>Inline width and height</title>
<script>
  const element = document.createElement("div");
  const style = element.style;
  const log = () => console.log(JSON.stringify([style.width, style.height]));

  log();
  element.style.width = "50%";
  element.style.height = "80px";
  log();

  element.style.width = "invalid";
  log();

  element.style.width = "";
  element.style.height = "auto";
  log();
</script>

Resultado

["",""]
["50%","80px"]
["50%","80px"]
["","auto"]

Guarda el ejemplo como archivo `.html`, ábrelo en un navegador y consulta la consola de desarrollo. El `div` no se inserta en el documento, así que las cuatro líneas muestran declaraciones, no mediciones de la disposición.

Lecciones relacionadas

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

Fuentes