有一個很常見的需求:點擊某個按鈕後,在按鈕下方彈出一層浮動視窗。要做這件事,你必須先知道按鈕在頁面中的位置,也就是它的 offset 值,然後才能算出浮層的 top 與 left。
看起來簡單,但這裡藏著一個經典的跨瀏覽器陷阱。
多數人第一個想到的是這樣:
document.getElementById("divFloat").style.top =
document.getElementById("Button").offsetLeft + 25;
這裡有兩個問題。第一,style 屬性必須帶單位,於是改成:
document.getElementById("divFloat").style.top =
document.getElementById("Button").offsetLeft + 25 + "px";
第二個問題更麻煩。用 IETester 與 Firefox 實測後發現,IE6 以上版本都正常,但 Firefox 取到的值就是不正確。
關鍵在於 offsetLeft 的定義:它返回的是元素相對於其 offsetParent 的距離,而不是相對於整個頁面的距離。如果按鈕被包在幾層帶有定位的容器裡,一層一層的位移就會被忽略掉。
正確做法是把祖先鏈上的偏移量全部加起來:
function getOffsetLeft(o) {
var left = 0;
var offsetParent = o;
while (offsetParent != null && offsetParent != document.body) {
left += offsetParent.offsetLeft;
offsetParent = offsetParent.offsetParent;
}
return left;
}
同理,把 offsetLeft 換成 offsetTop 就能取得垂直方向的偏移。這個迴圈就是所有 offset 計算的核心思想。
如果專案裡已經有 jQuery,那根本不必自己刻——offset() 早就幫你把各家瀏覽器的差異處理好了:
$("#Button").offset().left
$("#Button").offset().top
它內部是怎麼做的?大致如下:
jQuery.fn.extend({
position: function() {
if ( !this[0] ) { return null; }
var elem = this[0],
// 取得真正的 offsetParent
offsetParent = this.offsetParent(),
// 取得正確的偏移量
offset = this.offset(),
parentOffset = /^body|html$/i.test(offsetParent[0].nodeName)
? { top: 0, left: 0 }
: offsetParent.offset();
// 減去元素自身的 margin
// 注意:當元素設定 margin:auto 時,Safari 中 offsetLeft 與 marginLeft
// 會相同,導致 offset.left 錯誤地變成 0
offset.top -= parseFloat(jQuery.curCSS(elem, "marginTop", true)) || 0;
offset.left -= parseFloat(jQuery.curCSS(elem, "marginLeft", true)) || 0;
// 加上 offsetParent 的 border
parentOffset.top += parseFloat(jQuery.curCSS(offsetParent[0], "borderTopWidth", true)) || 0;
parentOffset.left += parseFloat(jQuery.curCSS(offsetParent[0], "borderLeftWidth", true)) || 0;
// 兩者相減
return {
top: offset.top - parentOffset.top,
left: offset.left - parentOffset.left
};
},
offsetParent: function() {
return this.map(function() {
var offsetParent = this.offsetParent || document.body;
while ( offsetParent &&
(!/^body|html$/i.test(offsetParent.nodeName) &&
jQuery.css(offsetParent, "position") === "static") ) {
offsetParent = offsetParent.offsetParent;
}
return offsetParent;
});
}
});
核心邏輯和我們手寫的版本大同小異,只是額外處理了 margin 與 border,也處理了 Safari 上 margin:auto 造成的特例。
offset() 的計算包含 border,但不包含 margin。這一點在做浮層定位時特別容易出問題:如果你希望浮層貼齊按鈕的視覺邊緣,就要把按鈕自身的 border 與 margin 一起納入計算。
function showFloat(btn, panel) {
var pos = btn.offset();
panel.css({
position: "absolute",
top: pos.top + btn.outerHeight() + "px",
left: pos.left + "px"
});
}
這裡特意用 outerHeight() 而不是 height(),因為前者含 padding 與 border,才能讓浮層真正落在按鈕的「下緣」。
如果今天重寫,不必再依賴 jQuery,原生 API 已經足夠:
const rect = btn.getBoundingClientRect();
// 加上目前的捲動量,換算成頁面座標
const top = rect.top + window.pageYOffset;
const left = rect.left + window.pageXOffset;
getBoundingClientRect() 回傳的是相對於視窗的座標,因此要加上捲動距離才是頁面座標。它一次取得四邊位置,效能也比重複呼叫 offset 系列屬性更好。
總結:offset 的本質是「元素相對於 offsetParent 的距離」,跨瀏覽器的正確取值需要逐層累加並校正 margin / border。手寫一次有助理解,但專案裡請直接用 getBoundingClientRect() 或成熟的函式庫。