The HTMLElement.offsetWidth
read-only property returns the layout width of an element as an integer.
Typically, offsetWidth
is a measurement in pixels of the element's CSS width, including any borders, padding, and vertical scrollbars (if rendered). It does not include the width of pseudo-elements such as ::before
or ::after
.
If the element is hidden (for example, by setting style.display
on the element or one of its ancestors to "none"
), then 0
is returned.
Syntax
var intElemOffsetWidth = element.offsetWidth;
intElemOffsetWidth
is a variable storing an integer corresponding to the offsetWidth
pixel value of the element. The offsetWidth
property is a read-only.
This property will round the value to an integer. If you need a fractional value, use element.getBoundingClientRect()
.
Example
Specification
Specification | Status | Comment |
---|---|---|
CSS Object Model (CSSOM) View Module The definition of 'offsetWidth' in that specification. |
Working Draft |
Notes
offsetWidth
is a property of the DHTML object model which was first introduced by MSIE. It is sometimes referred to as an element's physical/graphical dimensions, or an element's border-box width.
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
offsetWidth | Chrome Full support 1 | Edge Full support 12 | Firefox Full support 1 | IE Full support 8 | Opera Full support 8 | Safari Full support 3 | WebView Android Full support 1 | Chrome Android Full support 18 | Firefox Android Full support 4 | Opera Android Full support 10.1 | Safari iOS Full support 1 | Samsung Internet Android Full support 1.0 |
Legend
- Full support
- Full support