談元素位置時,最容易混淆的就是「相對於誰」。同一個元素可以有一組「文檔座標」,也可以有一組「視口座標」,兩者的差別在於原點在哪裡,以及會不會隨捲動改變。這篇文章把這件事講清楚。
元素位置以像素衡量,向右是 X 增加,向下是 Y 增加。但有兩個可能的原點:文檔的左上角,或目前顯示文檔的視口左上角。
所謂視口,指的是瀏覽器中真正用來顯示網頁內容的那塊區域,不含外殼(工具列、書籤列、分頁等)。若文檔在框架中顯示,視口就是該 <iframe> 元素。

兩者的關係很單純:文檔座標 − 捲動偏移量 = 視口座標。舉例來說,某元素在文檔座標中的 Y 是 200px,使用者已向下捲動 75px,那麼它在視口座標中的 Y 就是 125px。反之,若某元素視口座標 X 為 400px,而水平已捲動 200px,則文檔座標 X 為 600px。
文檔座標比視口座標更「基礎」——使用者捲動時它不會改變。但實務上視口座標更常用:getBoundingClientRect() 回傳的是視口座標,滑鼠事件回報的 clientX/clientY 也是視口座標。而 CSS 定位(position: absolute)用的是文檔座標。

要在兩套座標間轉換,得先知道捲軸位置。window.pageXOffset / pageYOffset 是最乾淨的方式(IE8 及更早不支援);另一條路是讀 scrollLeft / scrollTop,但要注意標準模式下要查 document.documentElement,怪異模式(quirks mode)下則要查 document.body:
function getScrollOffsets(w) {
w = w || window;
if (w.pageXOffset != null) {
return { x: w.pageXOffset, y: w.pageYOffset };
}
var d = document;
if (d.compatMode == "CSS1Compat") { // 標準模式
return {
x: d.documentElement.scrollLeft || d.body.scrollLeft,
y: d.documentElement.scrollTop || d.body.scrollTop
};
}
return { x: d.body.scrollLeft, y: d.body.scrollTop }; // 怪異模式
}
innerHeight / innerWidth:視口內容區的高度與寬度。outerHeight / outerWidth:整個瀏覽器視窗的尺寸,含所有介面元件。pageXOffset / pageYOffset:捲軸的 X / Y 位置(別名 scrollX / scrollY)。在 document.documentElement 與 document.body 上,有這幾組屬性:
clientHeight / clientWidth:可見內容的尺寸,不含捲軸。offsetHeight / offsetWidth:內容尺寸並含捲軸與邊框。offsetLeft / offsetTop:相對於 offsetParent 的位置。scrollHeight / scrollWidth:可捲動內容的整體尺寸,含被遮住的部分但不含捲軸。scrollTop / scrollLeft:目前的捲動量。
function getViewportSize(w) {
w = w || window;
if (w.innerWidth != null) {
return { w: w.innerWidth, h: w.innerHeight };
}
var d = document;
if (d.compatMode == "CSS1Compat") { // 標準模式
return { w: d.documentElement.clientWidth, h: d.documentElement.clientHeight };
}
return { w: d.body.clientWidth, h: d.body.clientHeight }; // 怪異模式
}
知道視口尺寸後,就能判斷「元素目前是否落在可見範圍內」,這是實作無限捲動、延遲載入圖片的基礎。判斷方式是把元素的 getBoundingClientRect() 結果與視口寬高比較:
function isVisible(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);
}
以上大量的相容判斷在今天多半不需要了。除了 getBoundingClientRect(),還有幾個更好用的 API:
// 元素相對於視口的位置
var r = document.getElementById('box').getBoundingClientRect();
console.log(r.top, r.left, r.width, r.height);
// 轉成文檔座標:加上捲動量
var docTop = r.top + window.pageYOffset;
var docLeft = r.left + window.pageXOffset;
// 更簡潔的捲動量讀取
var sx = window.scrollX, sy = window.scrollY;
// 元素是否進入視口,交給瀏覽器判斷(效能遠優於自行計算)
new IntersectionObserver(function (entries) {
entries.forEach(function (entry) {
if (entry.isIntersecting) console.log('進來了', entry.target);
});
}).observe(document.getElementById('box'));
IntersectionObserver 幾乎取代了所有手動算座標的捲動監聽,因為它把計算交給瀏覽器最佳化,不會在主執行緒上造成捲動卡頓。若只是要「元素完整進入視口時觸發一次」,它就是最合適的工具。