HTMLElement.offsetWidth

HTMLElement.offsetWidth 読み取り専用プロパティは、要素のレイアウト幅を整数として返します。

通常、offsetWidth は、境界線、パディング、および垂直スクロールバー(レンダリングされている場合)を含む、要素の CSS width のピクセル単位の測定値です。 ::before::after などの擬似要素の幅は含まれません。

(例えば、要素またはその祖先のいずれかで style.display"none" に設定することにより)要素が非表示の場合、0 が返されます。

構文

var intElemOffsetWidth = element.offsetWidth;

intElemOffsetWidth は、要素の offsetWidth ピクセル値に対応する整数を格納する変数です。 offsetWidth プロパティは読み取り専用です。

このプロパティは、値を整数に丸めます。 小数値が必要な場合は、element.getBoundingClientRect() を使用します。

Image:Dimensions-offset.png

仕様

仕様 状態 コメント
CSS Object Model (CSSOM) View Module
offsetWidth の定義
草案

ノート

offsetWidth は、MSIE によって最初に導入された DHTML オブジェクトモデルのプロパティです。 要素の物理的/グラフィカルな寸法、または要素の境界ボックスの幅(border-box width)と呼ばれることもあります。

ブラウザーの互換性

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung Internet
offsetWidth
実験的
Chrome 完全対応 47Edge 完全対応 12Firefox 完全対応 1IE 完全対応 ありOpera 完全対応 ありSafari 完全対応 11WebView Android 完全対応 47Chrome Android 完全対応 47Firefox Android 完全対応 4Opera Android 完全対応 ありSafari iOS 完全対応 ありSamsung Internet Android ?

凡例

完全対応  
完全対応
実装状況不明  
実装状況不明
実験的。動作が変更される可能性があります。
実験的。動作が変更される可能性があります。

関連情報