CKTIS / JavaScript
Dimensiones internas de un elemento: clientWidth y clientHeight
`clientWidth` y `clientHeight` leen la anchura y la altura internas de un elemento en píxeles CSS enteros. Incluyen el relleno, pero no los bordes, los márgenes ni el espacio ocupado por las barras de desplazamiento.
Versión: Current web platform; runtime support varies
Sintaxis
element.clientWidth
element.clientHeightclientWidth y clientHeight son propiedades de solo lectura de Element. Se leen sin paréntesis y dan la anchura y la altura en píxeles CSS enteros. Son de CSSOM View, no de ECMAScript, y requieren un DOM que calcule la disposición.
Incluyen contenido y padding, no bordes ni márgenes. Las barras que ocupan espacio reducen la anchura (vertical) o la altura (horizontal). Sin caja (display: none) o en un elemento en línea normal, dan 0 × 0; un inline-block sí se mide.
Para medir el layout viewport sin el espacio de las barras, lee document.documentElement en modo estándar o document.body en modo quirks.
scrollWidth y scrollHeight incluyen el contenido desbordado. getBoundingClientRect() incluye el borde, refleja las transformaciones CSS y admite medidas fraccionarias.
Ejemplos
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<title>clientWidth and clientHeight</title>
</head>
<body>
<script>
const box = document.createElement('div');
box.style.cssText = 'display: block; box-sizing: content-box; width: 120px; height: 60px; padding: 8px 12px; border: 3px solid; margin: 10px; overflow: hidden;';
document.body.append(box);
console.log(`${box.clientWidth} × ${box.clientHeight}`);
box.style.display = 'none';
console.log(`${box.clientWidth} × ${box.clientHeight}`);
box.remove();
</script>
</body>
</html>Resultado
144 × 76 0 × 0
Guarda el ejemplo como archivo HTML, ábrelo en un navegador y consulta la consola. La primera línea cuenta 12 px de relleno a izquierda y derecha y 8 px arriba y abajo, pero no el borde ni el margen. Tras establecer `display: none`, ambas medidas son cero.
Lecciones relacionadas
- JavaScript · Lección 27 · Intermedio · Versión: 3