The Element.clientWidth
property is zero for inline elements and elements with no CSS; otherwise, it's the inner width of an element in pixels. It includes padding but excludes borders, margins, and vertical scrollbars (if present).
When clientWidth
is used on the root element (the <html>
element), (or on <body>
if the document is in quirks mode), the viewport's width (excluding any scrollbar) is returned. This is a special case of clientWidth
.
Note: This property will round the value to an integer. If you need a fractional value, use element.getBoundingClientRect()
.
Syntax
var intElemClientWidth = element.clientWidth;
intElemClientWidth
is an integer corresponding to the clientWidth
of element
in pixels. The clientWidth
property is read–only.
Example
[[File:../../../../../../media.prod.mdn.mozit.cloud/attachments/2012/07/09/346/e376ef78f757870d6d5327498c745681/Dimensions-client.png|class=internal|Image:Dimensions-client.png]]
Specification
Specification | Status | Comment |
---|---|---|
CSS Object Model (CSSOM) View ModuleThe definition of 'clientWidth' in that specification. | Working Draft |
Notes
clientWidth
was first introduced in the MS IE DHTML object model.
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
clientWidth
|
Chrome
Full support 43 |
Edge
Full support 12 |
Firefox
Full support 1 |
IE
Full support 6 |
Opera
Full support 8 |
Safari
Full support 6 |
WebView Android
Full support 43 |
Chrome Android
Full support 43 |
Firefox Android
Full support 4 |
Opera Android
Full support 10.1 |
Safari iOS
Full support 6 |
Samsung Internet Android
Full support 4.0 |
Legend
- Full support
- Full support
See also
Element.clientWidth by Mozilla Contributors is licensed under CC-BY-SA 2.5.