元素的尺寸與滾動位置相關屬性名稱相近、行為卻各異,是前端定位計算中最容易出錯的一塊。以下用一個實際例子逐一對照。
<div style="width:300px; height:300px; padding:2px; margin:3px;">
<div id="t1"
style="margin:1px; padding:4px; border:3px solid #eeeeee;
width:100px; height:200px; overflow:scroll; cursor:pointer;"
onclick="testClick('t1')">
...內容文字...
</div>
</div>
用一個函式把各項數值印出來:
function testClick(id) {
var el = document.getElementById(id);
alert(
"offsetHeight: " + el.offsetHeight + "\n" +
"offsetWidth: " + el.offsetWidth + "\n" +
"offsetLeft: " + el.offsetLeft + "\n" +
"offsetTop: " + el.offsetTop + "\n" +
"offsetParent: " + el.offsetParent + "\n" +
"scrollHeight: " + el.scrollHeight + "\n" +
"scrollWidth: " + el.scrollWidth + "\n" +
"scrollTop: " + el.scrollTop + "\n" +
"scrollLeft: " + el.scrollLeft
);
}
offsetHeight / offsetWidth:元素的外部尺寸,包含內容、內距(padding)與外框(border),但不含外边距(margin)。
以上面的內層 div 為例:高度 = 200(自身)+ 4×2(上下 padding)+ 3×2(上下 border)= 214;寬度 = 100 + 4×2 + 3×2 = 114。
offsetLeft:目前元素的左邊界,到其 offsetParent 左邊界的距離。計算上是父層的 padding + 父層的 border + 自身的 margin,也就是 2 + 3 + 1 = 6。注意自身的 padding 不影響這個值。
offsetTop:同理,計算方式與 offsetLeft 完全一致。
要特別記住:沒有 offsetRight 這個屬性。若需要「右邊界」,得自己用 offsetLeft + offsetWidth 推算。
scrollHeight / scrollWidth:元素內容的完整尺寸,包含被隱藏、需要捲動才看得到的部分。
差別在 overflow 的設定:
overflow: hidden 時,scrollHeight 只回報實際可見的高度,超出部分雖然存在但不計入overflow: scroll 時,scrollHeight 會包含內容的完整高度,同時也把水平滾動條的高度算進來這也解釋了為什麼「有滾動條時 scrollHeight 反而變大」——它把滾動條本身佔的空間也計入了。
scrollTop / scrollLeft:已經捲動的距離。只有在元素真的可捲動(例如 overflow 設為 auto 或 scroll)時才有意義。未捲動時預設為 0。
這兩個屬性也可以寫入,用來程式化地捲動頁面或元素,是實作「回到頂端」按鈕、滾動同步的基本工具。
第一,這些數值回傳的都是整數。在支援縮放或高 DPI 的環境中,實際值可能是小數,四捨五入會造成 1px 的累積誤差,需要精準對齊時要留意。
第二,讀取 offset 系列屬性會強制瀏覽器同步完成版面計算(reflow)。在迴圈中反覆讀寫這類屬性,是常見的效能燙手山芋。若必須頻繁讀取,請先在批次中讀完、再批次寫入。
第三,若要取得元素相對於整個頁面的位置,getBoundingClientRect() 通常比手動累加 offsetLeft/offsetTop 更方便,而且能同時拿到 left、right、top、bottom 四個值。