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

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.clientHeight

clientWidth 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

Fuentes