Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Dimensões interiores de um elemento: clientWidth e clientHeight

`clientWidth` e `clientHeight` leem a largura e a altura interiores de um elemento em píxeis CSS inteiros. Incluem o preenchimento, mas não as bordas, as margens nem o espaço ocupado pelas barras de deslocamento.

Versão: Current web platform; runtime support varies

Sintaxe

element.clientWidth
element.clientHeight

clientWidth e clientHeight são propriedades de leitura de Element. Leem-se sem parênteses e dão a largura e a altura em píxeis CSS inteiros. São de CSSOM View, não de ECMAScript, e exigem um DOM que calcule a disposição da página.

Incluem o conteúdo e o padding, não as bordas nem as margens. As barras que ocupam espaço reduzem a largura (vertical) ou a altura (horizontal). Sem caixa (display: none) ou num elemento em linha normal, dão 0 × 0; um inline-block é medido.

Para medir o layout viewport sem o espaço das barras, lê document.documentElement no modo de normas ou document.body no modo quirks.

scrollWidth e scrollHeight incluem o conteúdo que transborda. getBoundingClientRect() inclui a borda, reflete as transformações CSS e pode dar medidas fracionárias.

Exemplos

<!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 o exemplo num ficheiro HTML, abre-o num navegador e consulta a consola. A primeira linha conta 12 px de preenchimento à esquerda e à direita e 8 px em cima e em baixo, mas não a borda nem a margem. Depois de definires `display: none`, ambas as medidas são zero.

Lições relacionadas

  • JavaScript · Lição 27 · Intermédio · Versão: 3

Fontes