DIV CSS 佈局教程網

JavaScript 取得 DOM 元素的位置與尺寸:屬性、座標與兼容性
編輯:JavaScript基礎知識     

在較複雜的頁面裡用 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 就能輕鬆補上。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved