--- title: element.clientWidth slug: Web/API/Element/clientWidth tags: - API - CSSOM View - Propriété - Reference translation_of: Web/API/Element/clientWidth ---
La propriété Element.clientWidth
vaut zéro pour les éléments en ligne (inline) et pour les éléments sans CSS. Dans les autres cas, sa valeur correspond à la largeur intérieure d'un élément, exprimée en pixel. Cette largeur inclue le rembourrage (padding) mais exclut les bordures, les marges et les éventuelles barres de défilement verticales.
Lorsque clientWidth
est utilisée sur l'élément racine (l'élément <html>
par défaut ou <body>
si le document utilise le mode quirks), c'est la largeur de la zone d'affichage (viewport) à l'exception des barres de défilement qui est renvoyée. Il s'agit d'un cas au limite pour clientWidth
.
Note : La valeur de cette propriété sera arondie en un entier. Si vous devez utiliser une valeur décimale, privilégiez {{domxref("element.getBoundingClientRect()")}}.
var intElemClientWidth = element.clientWidth;
intElemClientWidth
est un entier correspondant à la largeur d'element
, en pixels. La propriété clientWidth
est uniquement accessible en lecture-seule.
Spécification | État | Commentaires |
---|---|---|
{{SpecName('CSSOM View', '#dom-element-clientwidth', 'clientWidth')}} | {{Spec2("CSSOM View")}} |
clientWidth
fut d'abord introduit avec le modèle objet DHTML de Microsoft Internet Explorer.
{{Compat("api.Element.clientWidth")}}