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)と呼ばれることもあります。

ブラウザーの互換性

BCD tables only load in the browser

関連情報