--- title: HTMLElement.offsetWidth slug: Web/API/HTMLElement/offsetWidth tags: - API - CSSOM View - Property - Read-only - Reference translation_of: Web/API/HTMLElement/offsetWidth ---
HTMLElement.offsetWidth
読み取り専用プロパティは、要素のレイアウト幅を整数として返します。
通常、offsetWidth
は、境界線、パディング、および垂直スクロールバー(レンダリングされている場合)を含む、要素の CSS width のピクセル単位の測定値です。 ::before
や ::after
などの擬似要素の幅は含まれません。
(例えば、要素またはその祖先のいずれかで style.display
を "none"
に設定することにより)要素が非表示の場合、0
が返されます。
var intElemOffsetWidth = element.offsetWidth;
intElemOffsetWidth
は、要素の offsetWidth
ピクセル値に対応する整数を格納する変数です。 offsetWidth
プロパティは読み取り専用です。
このプロパティは、値を整数に丸めます。 小数値が必要な場合は、{{ domxref("element.getBoundingClientRect()") }} を使用します。
仕様 | 状態 | コメント |
---|---|---|
{{SpecName('CSSOM View', '#dom-htmlelement-offsetwidth', 'offsetWidth')}} | {{Spec2('CSSOM View')}} |
offsetWidth
は、MSIE によって最初に導入された DHTML オブジェクトモデルのプロパティです。 要素の物理的/グラフィカルな寸法、または要素の境界ボックスの幅(border-box width)と呼ばれることもあります。
{{Compat("api.HTMLElement.offsetWidth")}}