HTMLElement: offsetLeft プロパティ
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。
offsetLeft は HTMLElement インターフェイスの読み取り専用プロパティで、現在の要素の左上隅が HTMLElement.offsetParent ノード内で左へオフセットされるピクセル数を返します。
ブロックレベル要素では、offsetTop、offsetLeft、offsetWidth、offsetHeight は、offsetParent を基準とする要素の境界ボックスを表します。
しかし、<span> のようなインラインレベル要素は行をまたいで折り返すことがあります。この場合、offsetTop と offsetLeft は最初の境界ボックスの位置を表し(幅と高さを取得するには Element.getClientRects() を使用)、offsetWidth と offsetHeight は囲む境界ボックスの寸法を表します(位置を取得するには Element.getBoundingClientRect() を使用)。したがって、offsetLeft、offsetTop、offsetWidth、offsetHeight で得られる左、上、幅、高さは、テキストが折り返された <span> の境界ボックスにはなりません。
値
整数です。
例
js
const colorTable = document.getElementById("t1");
const tOLeft = colorTable.offsetLeft;
if (tOLeft > 5) {
// 大きな左オフセットがある場合の処理
}
この例では、青い境界線を持つ div 内で折り返す「長い」文と、span の境界を表すと考えられる赤いボックスを示します。

html
<div class="span-container">
<span>Short span.</span>
<span id="long-span">Long span that wraps within this div.</span>
</div>
<div id="box"></div>
css
.span-container {
width: 300px;
border-color: blue;
border-style: solid;
border-width: 1px;
}
#box {
position: absolute;
border-color: red;
border-width: 1px;
border-style: solid;
z-index: 10;
}
js
const box = document.getElementById("box");
const longSpan = document.getElementById("long-span");
box.style.left = `${longSpan.offsetLeft}${document.body.scrollLeft}px`;
box.style.top = `${longSpan.offsetTop}${document.body.scrollTop}px`;
box.style.width = `${longSpan.offsetWidth}px`;
box.style.height = `${longSpan.offsetHeight}px`;
仕様書
| 仕様書 |
|---|
| CSSOM View Module> # dom-htmlelement-offsetleft> |