HTML DOM clientWidth Property
Example
Get the height and width of a <div> element, including padding:
var elmnt = document.getElementById("myDIV");
var txt = "Height with padding: " + elmnt.clientHeight + "px<br>";
txt += "Width with padding: " + elmnt.clientWidth + "px";
Try it Yourself »
More "Try it Yourself" examples below.
Definition and Usage
The clientWidth property returns the viewable width of an element in pixels, including padding, but not the border, scrollbar or margin.
The reason why the "viewable" word is specified, is because if the element's content is wider than the actual width of the element, this property will only return the width that is visible (See "More Examples").
Note: To understand this property, you must understand the CSS Box Model.
Tip: This property is often used together with the clientHeight property.
Tip: Use the offsetHeight and offsetWidth properties to return the viewable height and width of an element, including padding, border and scrollbar.
Tip: To add scrollbars to an element, use the CSS overflow property.
This property is read-only.
Browser Support
| Property | |||||
|---|---|---|---|---|---|
| clientWidth | Yes | Yes | Yes | Yes | Yes |
Syntax
element.clientWidth
Technical Details
| Return Value: | A Number, representing the viewable width of an element in pixels, including padding |
|---|
More Examples
Example
This example demonstrates the difference between clientHeight/clientWidth and offsetHeight/offsetWidth:
var elmnt = document.getElementById("myDIV");
var txt = "";
txt += "Height with padding: " + elmnt.clientHeight + "px<br>";
txt += "Height with padding and border: " + elmnt.offsetHeight + "px<br>";
txt += "Width with padding: " + elmnt.clientWidth + "px<br>";
txt += "Width with padding and border: " + elmnt.offsetWidth + "px";
Try it Yourself »
Example
This example demonstrates the difference between clientHeight/clientWidth and offsetHeight/offsetWidth, when we add a scrollbar to the element:
var elmnt = document.getElementById("myDIV");
var txt = "";
txt += "Height with padding: " + elmnt.clientHeight + "px<br>";
txt += "Height with padding, border and scrollbar: " + elmnt.offsetHeight + "px<br>";
txt += "Width with padding: " + elmnt.clientWidth + "px<br>";
txt += "Width with padding, border and scrollbar: " + elmnt.offsetWidth + "px";
Try it Yourself »
