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