在一些複雜頁面中,我們常用 JavaScript 處理 DOM 元素的動態效果,這時經常需要計算元素的位置與尺寸,而瀏覽器相容性問題也不可忽略。要寫出符合預期效果的程式碼,得先具備一些基礎知識。
每個 HTML 元素都有下列屬性:offsetWidth、clientWidth、scrollWidth、offsetHeight、clientHeight、scrollHeight、offsetLeft、clientLeft、scrollLeft、offsetTop、clientTop、scrollTop。
要理解這些屬性,得先知道:元素的實際內容可能比用來容納它的盒子更大,此時會出現捲軸。內容區域就是視口,當實際內容比視口大時,就要把捲軸位置一併考慮進去。
<div id="divParent" style="padding: 8px; background-color: #aaa; position: relative;">
<div id="divDisplay" style="background-color: #0f0; margin: 30px; padding: 10px;
height: 200px; width: 200px; border: solid 3px #f00;">
</div>
</div>
<script type="text/javascript">
var div = document.getElementById('divDisplay');
var clientHeight = div.clientHeight;
var clientWidth = div.clientWidth;
div.innerHTML += 'clientHeight: ' + clientHeight + '<br/>';
div.innerHTML += 'clientWidth: ' + clientWidth + '<br/>';
var clientLeft = div.clientLeft;
var clientTop = div.clientTop;
div.innerHTML += 'clientLeft: ' + clientLeft + '<br/>';
div.innerHTML += 'clientTop: ' + clientTop + '<br/>';
var offsetHeight = div.offsetHeight;
var offsetWidth = div.offsetWidth;
div.innerHTML += 'offsetHeight: ' + offsetHeight + '<br/>';
div.innerHTML += 'offsetWidth: ' + offsetWidth + '<br/>';
var offsetLeft = div.offsetLeft;
var offsetTop = div.offsetTop;
div.innerHTML += 'offsetLeft: ' + offsetLeft + '<br/>';
div.innerHTML += 'offsetTop: ' + offsetTop + '<br/>';
var offsetParent = div.offsetParent;
div.innerHTML += 'offsetParent: ' + offsetParent.id + '<br/>';
</script>

從結果可以看出:clientHeight 就是 div 高度加上下各 10px 的 padding;clientLeft、clientTop 則是 div 的上、左邊框寬度;offsetHeight 是 clientHeight 再加上下各 3px 的邊框寬度;offsetTop 是 div 的 30px margin 加上 offsetParent 的 8px padding。
此外,scrollWidth / scrollHeight 是元素內容區域加上內邊距再加上溢出尺寸;當內容正好填滿、沒有溢出時,它們與 clientWidth、clientHeight 相等。scrollLeft / scrollTop 則是捲軸位置,可讀可寫。
<div id="divParent" style="background-color: #aaa; padding:8px; border:solid 7px #000; height:200px; width:500px; overflow:auto;">
<div id="divDisplay" style="background-color: #0f0; margin: 30px; padding: 10px;
height: 400px; width: 200px; border: solid 3px #f00;">
</div>
</div>
在 Firefox 與 IE10 下得到 scrollHeight 為 494,而在 Chrome 與 Safari 下卻是 502,差了 8px。仔細推算:divDisplay 所需高度為 400 + 10×2 + 3×2 + 30×2 = 486,486 + 8 = 494,486 + 8×2 = 502。可見差別就在於 divParent 的 padding——Firefox 與 IE10 沒有把它計算進去。
計算元素坐標時會涉及兩種坐標系:文檔坐標與視口坐標。document 代表整個頁面,包含因視窗大小限制而需滾動的部分,其左上角即文檔坐標原點;視口則是瀏覽器中顯示文檔內容的部分,不含外殼與捲軸。若文檔比視口小則無捲動,兩者左上角重合;一般情況下,兩種坐標系切換需加上或減去捲動偏移量。
要取得捲軸位置,window 的 pageXoffset、pageYoffset 提供了這些值(IE8 及更早除外);也可透過 scrollLeft、scrollTop 取得,正常情況查詢 document.documentElement,怪異模式則要查 document.body。
function getScrollOffsets(w) {
var w = w || window;
if (w.pageXoffset != null) {
return { x: w.pageXoffset, y: pageYoffset };
}
var d = w.document;
if (document.compatMode == "CSS1Compat")
return { x: d.documentElement.scrollLeft, y: d.documentElement.scrollTop };
return { x: d.body.scrollLeft, y: d.body.scrollTop };
}
取得視口尺寸也很有用:
function getViewPortSize(w) {
var w = w || window;
if (w.innerWidth != null)
return { w: w.innerWidth, h: w.innerHeight };
var d = w.document;
if (document.compatMode == "CSS1Compat")
return { w: d.documentElement.clientWidth, h: d.documentElement.clientHeight };
return { w: d.body.clientWidth, h: d.body.clientHeight };
}
任何 HTML 元素都有 offsetLeft、offsetTop 屬性,對多數元素來說它們是文檔坐標,但對於定位元素的後代及某些元素(如表格單元),返回的是相對於祖先的坐標。此時可以透過簡單的遞歸上溯累加來計算:
function getElementPosition(e) {
var x = 0, y = 0;
while (e != null) {
x += e.offsetLeft;
y += e.offsetTop;
e = e.offsetParent;
}
return { x: x, y: y };
}
不過這個函式並不總是準確——當文檔含有捲軸時它就無法正常工作,只能在無捲軸時使用。即便如此,我們仍能藉由這個原理算出元素相對於某個父元素的坐標。
計算視口坐標則相對簡單,可以呼叫元素的 getBoundingClientRect 方法。它返回一個帶有 left、right、top、bottom 屬性的物件,分別表示元素四邊相對於視口的坐標。返回值包含元素的內邊距與邊框,但不含外邊距,相容性很好,非常實用。
有了上述方法,便能輕易得出元素尺寸。在符合 W3C 標準的瀏覽器中,getBoundingClientRect 返回的物件還包含 width 與 height;但在早期 IE 中並未實作,此時可用 right - left 與 bottom - top 計算得出。