要計算元素在頁面上的位置——例如讓浮動提示對齊某個按鈕、判斷元素是否已捲進視窗——offset() 是最直接的工具。
var left = $("#div").offset().left; // 距離視窗左側的偏移量
var top = $("#div").offset().top; // 距離視窗頂部的偏移量
這兩個方法很容易搞混:
offset():相對於文件(document)的座標。不受父元素定位影響,會隨頁面捲動而改變數值。position():相對於最近的定位祖先元素的座標。用來算元素在容器內的位置。<div style="position:relative; margin:100px">
<span id="inner">文字</span>
</div>
$("#inner").offset().top; // 約 100(含 body 邊距,相對文件)
$("#inner").position().top; // 0(相對定位父元素)
offset() 除了讀取,也能寫入,直接把元素移到指定座標:
$("#div").offset({ top: 200, left: 300 });
不引入 jQuery 的話,用 getBoundingClientRect():
var rect = document.getElementById('div').getBoundingClientRect();
console.log(rect.left, rect.top);
// 注意:這兩個值是相對於「目前可視區域」,需要加上捲動量才是文件座標
var docTop = rect.top + window.pageYOffset;
var docLeft = rect.left + window.pageXOffset;
這裡有個容易忽略的細節:getBoundingClientRect() 回傳的是視窗座標,捲動頁面後同一元素的 top 會變小,而 jQuery 的 offset() 回傳的是固定的文件座標。兩者不能直接互換。
function isInViewport(el) {
var rect = el.getBoundingClientRect();
return rect.top >= 0 && rect.left >= 0 &&
rect.bottom <= (window.innerHeight || document.documentElement.clientHeight) &&
rect.right <= (window.innerWidth || document.documentElement.clientWidth);
}
若要在捲動時持續偵測(例如無限滾動、圖片懶載入),請用 IntersectionObserver,效能遠優於在 scroll 事件中不斷呼叫 offset:
var observer = new IntersectionObserver(function(entries) {
entries.forEach(function(entry) {
if (entry.isIntersecting) {
console.log('元素進入了視窗', entry.target);
}
});
});
observer.observe(document.getElementById('div'));
這是一個實務上常踩的坑:offset() 的回傳值包含 CSS transform 造成的位移,但 getBoundingClientRect() 也包含。若元素上有 scale(),兩者回傳的寬高都會是縮放後的實際渲染尺寸,而非 CSS 中設定的 width/height。需要未縮放值時得自行換算。