Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Dimensions intérieures d’un élément : clientWidth et clientHeight

`clientWidth` et `clientHeight` donnent la largeur et la hauteur intérieures d’un élément en pixels CSS entiers. Le remplissage est compris, mais pas les bordures, les marges ni l’espace occupé par les barres de défilement.

Version : Current web platform; runtime support varies

Syntaxe

element.clientWidth
element.clientHeight

clientWidth et clientHeight sont des propriétés de Element en lecture seule, à lire sans parenthèses. Elles donnent la largeur et la hauteur en pixels CSS entiers. Elles relèvent de CSSOM View, non d’ECMAScript, et nécessitent un DOM avec mise en page.

Le contenu et le padding comptent, pas les bordures ni les marges. Les barres de défilement qui prennent de la place réduisent la largeur (verticale) ou la hauteur (horizontale). Sans boîte (display: none) ou en ligne ordinaire, on obtient 0 × 0 ; une boîte inline-block est mesurée.

Pour le layout viewport hors barres, lisez document.documentElement en mode standard ou document.body en mode quirks.

scrollWidth et scrollHeight incluent le contenu débordant. getBoundingClientRect() inclut la bordure, tient compte des transformations et peut donner des dimensions fractionnaires.

Exemples

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

Résultat

144 × 76
0 × 0

Enregistrez l’exemple dans un fichier HTML, ouvrez-le dans un navigateur et consultez la console. La première ligne compte 12 px de remplissage à gauche et à droite et 8 px en haut et en bas, mais pas la bordure ni la marge. Après `display: none`, les deux mesures valent zéro.

Leçons associées

  • JavaScript · Leçon 27 · Intermédiaire · Version : 3

Sources