Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Dimensioni interne di un elemento: clientWidth e clientHeight

`clientWidth` e `clientHeight` leggono la larghezza e l’altezza interne di un elemento in pixel CSS interi. Includono il padding, ma non i bordi, i margini o lo spazio occupato dalle barre di scorrimento.

Versione: Current web platform; runtime support varies

Sintassi

element.clientWidth
element.clientHeight

clientWidth e clientHeight sono proprietà di sola lettura di Element: senza parentesi, danno larghezza e altezza in pixel CSS interi. Fanno parte di CSSOM View, non di ECMAScript, e richiedono un DOM con supporto per il layout.

Includono contenuto e padding, non bordi o margini. Le barre che occupano spazio riducono la larghezza (verticale) o l’altezza (orizzontale). Senza box (display: none) o per un normale elemento in linea, danno 0 × 0; un inline-block viene misurato.

Per il viewport di layout senza lo spazio delle barre, leggi document.documentElement in modalità standard o document.body in modalità quirks.

scrollWidth e scrollHeight includono il contenuto che deborda. getBoundingClientRect() include il bordo, riflette le trasformazioni CSS e può dare misure frazionarie.

Esempi

<!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>

Risultato

144 × 76
0 × 0

Salva l’esempio come file HTML, aprilo in un browser e controlla la console. La prima riga conta 12 px di padding a sinistra e a destra e 8 px in alto e in basso, ma non il bordo o il margine. Dopo aver impostato `display: none`, entrambe le misure sono zero.

Lezioni correlate

  • JavaScript · Lezione 27 · Intermedio · Versione: 3

Fonti