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 element.getBoundingClientRect().

Syntaxe

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.

Exemple

Image:Dimensions-client.png

Spécifications

Spécification État Commentaires
CSS Object Model (CSSOM) View Module
La définition de 'clientWidth' dans cette spécification.
Version de travail

Notes

clientWidth fut d'abord introduit avec le modèle objet DHTML de Microsoft Internet Explorer.

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung Internet
clientWidthChrome Support complet 43Edge Support complet 12Firefox Support complet 1IE Support complet 6Opera Support complet 8Safari Support complet 6WebView Android Support complet 43Chrome Android Support complet 43Firefox Android Support complet 4Opera Android Support complet 10.1Safari iOS Support complet 6Samsung Internet Android Support complet 4.0

Légende

Support complet  
Support complet

Voir aussi