このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

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 の境界を表すと考えられる赤いボックスを示します。

「短い span。」という文。このテキストは青い境界線の div 内に完全に収まっています。「この div 内で折り返す長い span。」という文。「この div 内で折り返す長い span」の部分は赤い境界線のボックス内にあり、「この div 内」の部分は青い境界線の div 内にあります。

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

ブラウザーの互換性

関連情報