在較複雜的頁面裡用 JavaScript 做動態效果時,幾乎一定會碰到元素位置與尺寸的計算,而瀏覽器兼容性又是繞不開的一環。想寫出符合預期的程式碼,得先把基礎觀念釐清。
每個 HTML 元素都有下列屬性:
offsetWidth clientWidth scrollWidth offsetHeight clientHeight scrollHeight offsetLeft clientLeft scrollLeft offsetTop clientTop scrollTop
理解它們的前提是:元素的實際內容有可能比配置來容納內容的盒子更大,此時會出現捲軸,而內容區域就是視口;當實際內容大於視口,就必須把捲軸位置一起考慮進去。
1. clientHeight / clientWidth:元素的內尺寸,即「內容 + 內距」,不含邊框(IE 下實際包含)、外距與捲軸。
2. offsetHeight / offsetWidth:元素的外尺寸,即「內容 + 內距 + 邊框」,不含外距與捲軸。
3. clientTop / clientLeft:內距邊緣與邊框外緣之間的距離,也就是上、左邊框的寬度。
4. offsetTop / offsetLeft:元素左上角(邊框外緣)到已定位父容器(offsetParent)左上角的距離。
5. offsetParent:元素最近的定位(relative、absolute)祖先元素;向上遞歸查找,若都沒有定位祖先則回傳 null。
寫個小例子來驗證:
<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 即為左、上邊框寬度;offsetHeight 是 clientHeight 再加上上下各 3px 的邊框;offsetTop 則是 div 的 30px margin 加上 offsetParent 的 8px padding。
6. scrollWidth / scrollHeight:元素的內容區域加內距再加上溢出尺寸。當內容剛好填滿、沒有溢出時,它們與 clientWidth / clientHeight 相等。
7. 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>
<script type="text/javascript">
var divP = document.getElementById('divParent');
var divD = document.getElementById('divDisplay');
divD.innerHTML += 'scrollHeight: ' + divP.scrollHeight + '<br/>';
divD.innerHTML += 'scrollWidth: ' + divP.scrollWidth + '<br/>';
</script>
在 Firefox 與 IE10(IE10 以下版本的盒子模型與 W3C 標準不一致,此處不討論)下得到 scrollHeight 為 494,而 Chrome 與 Safari 下是 502,差了 8px。從這個 8 不難猜測是 divParent 的 padding,來算算看:
scrollHeight 必然包含 divDisplay 所需的高度:400px 加上上下各 10px padding、上下各 3px border、上下各 30px margin。
400 + 10*2 + 3*2 + 30*2 = 486 486 + 8 = 494 486 + 8*2 = 502
果然如此——Firefox 與 IE10 之下沒有把 padding 的雙側都計入。這類細微差異正是跨瀏覽器開發最容易栽跟頭的地方。
計算元素位置時會牽涉到兩套座標系。
文檔座標:我們常用的 document 指的是整個頁面,而不只是視窗可見部分,還包含因視窗大小限制而出現捲軸的那些內容。它的左上角就是文檔座標的原點。
視口座標:視口是顯示文檔內容的瀏覽器區域,不含瀏覽器外殼(選單、工具列、狀態列等),也就是當前視窗中顯示頁面的部分,不包含捲軸。
若文檔比視口小,表示沒有捲動,兩套座標的原點重合。一般情況下要互相轉換,加上或減去捲動偏移量即可。
取得捲軸位置時,window 的 pageXOffset / pageYOffset 是最直接的方式(IE8 及更早版本不支援);也可以查 scrollLeft / scrollTop,正常模式下從 document.documentElement 取, quirks 模式下則要從 document.body 取。
function getScrollOffsets(w) {
var w = w || window;
if (w.pageXOffset != null) {
return { x: w.pageXOffset, y: w.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 };
}
offsetLeft 與 offsetTop 回傳的是元素的 X、Y 座標,但對許多元素(尤其是定位元素的後代,以及表格儲存格)而言,那是相對於祖先元素而非文檔的座標。可以用遞歸上溯累加的方式解決:
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 就能輕鬆補上。