
這幾組屬性名字相似、含義卻大不相同,是前端定位與滾動計算的基礎。以下假設 obj 是某個 HTML 控件。
obj.offsetTop:obj 相對版面或 offsetParent 指定父座標的上側位置,整數,單位像素。
obj.offsetLeft:同上,取左側位置。
obj.offsetWidth:控件自身的絕對寬度,不含因 overflow 而未顯示的部分,也就是實際佔據的寬度。
obj.offsetHeight:控件自身的絕對高度,含義同上。
關於 offsetParent:它回傳定義了 offsetTop/offsetLeft 的容器物件參考。offsetTop 與 offsetParent 的關係相當複雜,不同瀏覽器解釋不同,元素浮動後又會再變,所以實務上只要理解「兩者搭配可取得控件在瀏覽器中的絕對位置」即可。以上屬性在 Firefox 中同樣有效。
要注意的是,這裡講的是 HTML 控件本身的屬性值,並非 document.body——後者在各瀏覽器中的解釋不一致(多數差異其實源於對 document.body 的解釋不同,而不是 offset 系列的算法不同)。
兩者都能取得元素距上方或外層元素的距離,但:
一、offsetTop 回傳數字,style.top 回傳帶單位的字串(如 px)。
二、offsetTop 唯讀,style.top 可讀可寫。
三、若從未指定 top 樣式,style.top 回傳空字串。
offsetLeft 與 style.left、offsetWidth 與 style.width、offsetHeight 與 style.height 也是同樣的道理。
clientHeight:內容可視區域的高度,也就是瀏覽器中看得到內容的那塊區域,大致是最後一條工具列以下、狀態列以上,與頁面實際內容無關。
offsetHeight:IE、Opera 認為它等於 clientHeight 加滾動條加邊框;而 Firefox、Netscape 認為它是網頁內容的實際高度,可以小於 clientHeight。
scrollHeight:IE、Opera 認為它是網頁內容的實際高度,可以小於 clientHeight;Firefox、Netscape 認為它是網頁內容高度,但最小不低於 clientHeight。
簡單歸納:clientHeight 是「透過瀏覽器看內容的區域高度」。Firefox 系列認為 offsetHeight 與 scrollHeight 都代表內容高度,只是當內容高度小於等於 clientHeight 時,scrollHeight 會等於 clientHeight,而 offsetHeight 仍可更小;IE、Opera 則認為 offsetHeight 是可視區域加滾動條加邊框,scrollHeight 才是內容實際高度。
clientWidth/offsetWidth/scrollWidth 的解釋完全類比,只是把高度換成寬度。
說明:以上以 HTML 4.01 Transitional DTD 為基礎。若改用 XHTML 1.0 Transitional,含義又會不同——在 XHTML 下這三個值相同,都表示內容的實際高度。新版瀏覽器多數會依頁面指定的 DOCTYPE 啟用不同解釋器。
scrollTop 是「捲起來」的高度值:
<div style="width:100px;height:100px;background-color:#FF0000;overflow:hidden;" id="p">
<div style="width:50px;height:300px;background-color:#0000FF;" id="t">
如果為 p 設定了 scrollTop,這些內容可能不會完全顯示。
</div>
</div>
<script type="text/javascript">
var p = document.getElementById("p");
p.scrollTop = 10;
</script>
為外層元素 p 設定 scrollTop 後,內層內容會向上捲動,這捲起來的部分就是 scrollTop。scrollLeft 同理,只是方向改為水平。
由於 offsetHeight 是元素自身的可視高度,而 scrollHeight 是內部內容的絕對高度(含被隱藏的部分),所以上例中 p 的 scrollHeight 是 300,offsetHeight 是 100。
IE 與 Firefox 完整支援這些屬性,Netscape 8 與 Opera 7.6 則不支援 scrollTop/scrollLeft(document.body 上的除外)。
clientHeight、clientWidth:顯示元素內容的像素高度與寬度,理論上不含樣式表加入的邊界、邊框等。
clientLeft、clientTop:回傳元素周圍邊框的厚度;若不指定邊框或未定位該元素,值為 0。
scrollLeft、scrollTop:元素可滾動時,可取得它在水平與垂直方向捲動的距離(像素);不可滾動的元素恆為 0。
scrollHeight、scrollWidth:不論有多少內容在頁面上可見,取的都是整體。
style.left:定位元素相對包含它的矩形左邊界的偏移量。
style.pixelLeft:回傳定位元素左邊界偏移量的整數像素值。因為非像素值會回傳帶單位的字串(如 30px),這個屬性可以單獨取出以像素為單位的數值。
style.posLeft:回傳定位元素左邊界偏移量的數值,不受樣式表指定單位影響。相對地,非位置值會回傳帶單位字串,例如 1.2em。top/pixelTop/posTop 依此類推。
left:從左向右移的位置,即掛件距螢幕左邊緣的距離。
clientLeft:回傳物件 offsetLeft 屬性值與到目前視窗左邊真實值之間的距離。
offsetLeft:回傳物件相對於父級對象的 left 值,以父級左上角為原點,向右向下為 X、Y 軸正方向的 x 座標。
pixelLeft:設定或回傳物件相對於視窗左邊的位置。
scrollWidth:物件的實際內容寬度,不含邊線,會隨內容多寡改變。
clientWidth:物件可見的寬度,不含滾動條等邊線,會隨視窗顯示大小改變。
offsetWidth:物件可見寬度,含滾動條等邊線,同樣隨視窗大小改變。
IE6.0、FF1.06 以上:
clientWidth = width + padding clientHeight = height + padding offsetWidth = width + padding + border offsetHeight = height + padding + border
IE5.0/5.5:
clientWidth = width - border clientHeight = height - border offsetWidth = width offsetHeight = height
另外補充:CSS 的 margin 屬性與 clientWidth、offsetWidth、clientHeight、offsetHeight 皆無關。
換個角度記:offsetWidth 是元素相對父元素的偏移寬度,等於 border 加 padding 加 width;clientWidth 是元素的可見寬度,等於 padding 加 width;scrollWidth 則是包含滾動部分的整體寬度。
<input type="button" value="點一下" onclick="move()">
<div id="d" style="background-color:#ff9966; position:absolute; left:170px; top:100px;
width:300; height:300; overflow:scroll"
onclick="alert('offsetLeft:'+this.offsetLeft)">
<div style="height:600;width:600" onclick="alert('offsetLeft:'+this.offsetLeft)"></div>
</div>
<script language="javascript">
function move() {
var d = document.getElementById("d");
a = eval(20);
d.scrollLeft += a;
}
</script>
存成網頁執行,點按鈕可看到滾動條移動;點擊內外層 div,會分別彈出內層相對於外層的位置,以及外層相對於視窗的位置。