W3cubDocs

/Web APIs

HTMLElement: offsetWidth property

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.

Value

An integer corresponding to the offsetWidth pixel value of the element. The offsetWidth property is a read-only.

Note: This property will round the value to an integer. If you need a fractional value, use element.getBoundingClientRect().

Examples

An example element with large padding, border and margin. offsetWidth is the layout width of the element including its padding and border, and excluding its margin.

Specifications

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
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
offsetWidth 1 12 1 5.5 8 3 4.4 18 4 10.1 1 1.0

See also

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/offsetWidth