DIV CSS 佈局教程網

JavaScript 取得視窗與元素尺寸、位置的屬性對照
編輯:JavaScript基礎知識     

取得視窗(容器)大小與位置的方法相當多,名稱又彼此相似,很容易混淆。以下分類列出並簡要說明。

座標與尺寸屬性

clientX/clientY:滑鼠相對於瀏覽器視窗客戶區(即可視區域)的水平、垂直座標。頁面捲動時值不變。

offsetX/offsetY:滑鼠相對於觸發事件元素本身的水平、垂直座標。

pageX/pageY:滑鼠相對於整個文件的座標,等於 clientX 加上水平捲動量。計算元素在文件中的絕對位置時常用。

screenX/screenY:滑鼠相對於整個螢幕的座標。

scrollWidth/scrollHeight:元素內容的完整寬度與高度(包含未顯示的部分)。

scrollLeft/scrollTop:可讀寫。設為某值即捲動到該位置;讀取則得到目前捲動量,也就是元素左/上邊界與可視內容左/上端的距離。

offsetWidth/offsetHeight:元素相對於版面(或由 offsetParent 指定的父座標)的寬與高,包含邊框與捲軸。

offsetLeft/offsetTop:元素相對版面或 offsetParent 的左側、頂端位置。

clientWidth/clientHeight:元素的內部寬高,包含 padding 但不含邊框與捲軸。

取得螢幕與視窗大小

螢幕解析度的高:window.screen.height

螢幕解析度的寬:window.screen.width

螢幕可用工作區高度(不含工作列):window.screen.availHeight

螢幕可用工作區寬度(不含工作列):window.screen.availWidth

網頁可視區域寬(不含捲軸與邊框):document.documentElement.clientWidth

網頁可視區域高(不含捲軸與邊框):document.documentElement.clientHeight

網頁可視區域寬(含捲軸與邊框):document.documentElement.offsetWidth

網頁可視區域高(含捲軸與邊框):document.documentElement.offsetHeight

網頁內容寬:document.documentElement.scrollWidth

網頁內容高:document.documentElement.scrollHeight

網頁被捲去的高度:document.documentElement.scrollTop(或 window.pageYOffset)

網頁被捲去的寬度:document.documentElement.scrollLeft(或 window.pageXOffset)

網頁正文部分上(內容最左邊距螢幕左緣):window.screenTop

網頁正文部分左(內容最上邊距螢幕上緣):window.screenLeft

關鍵陷阱:文件模式(Doctype)

有時會出現取不到值的情況,原因是 HTML 檔頭加了文件類型宣告:

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

這會讓瀏覽器進入標準模式(standards mode),此時 document.body.scrollTop 與 clientWidth 恆為 0,必須改讀 document.documentElement:

// 標準模式下
document.documentElement.scrollTop
document.documentElement.scrollLeft
document.documentElement.clientWidth
document.documentElement.clientHeight

// 相容模式(quirks mode,即不寫 doctype)下
document.body.scrollTop
document.body.clientWidth

這個差異困擾過很多人。實務上的通用寫法是兩者都試:

var scrollTop = window.pageYOffset
  || document.documentElement.scrollTop
  || document.body.scrollTop || 0;

或者直接用標準 API,完全不必理會模式差異:

var st = window.scrollY;
var sl = window.scrollX;
var vw = window.innerWidth;
var vh = window.innerHeight;

offsetParent 是什麼

offsetLeft/offsetTop 的參考點是最近的 offsetParent,也就是「CSS 中 position 屬性不為 static 的最近祖先元素」。若所有祖先都是 static,則以 body 為參考。這個特性經常被誤解——同一個元素在不同定位設定下,offsetTop 的值會不同。要取得相對整個文件的絕對位置,比較可靠的做法是遞迴累加,或直接用:

var rect = el.getBoundingClientRect();
var absoluteTop = rect.top + window.pageYOffset;
var absoluteLeft = rect.left + window.scrollX;

getBoundingClientRect() 是現代最推薦的方式,它回傳的物件含 top、right、bottom、left、width、height 六個值,且已經把所有 CSS 變換(transform)計算進去。

幾組容易混淆的對照

offsetWidth vs clientWidth:前者含 border 與 scrollbar,後者不含。設計 Modal 遮罩要蓋滿整個元素時用前者,計算內容可用寬度時用後者。

scrollHeight vs clientHeight:前者是內容完整高度,後者是可視高度。兩者相減就是「還有多少沒看到」,判斷是否捲到底時常用。

clientX vs pageX:頁面沒有捲動時兩者相同,捲動後差一個 scroll 量。要與 getBoundingClientRect 配合用 clientX,要算文件中的絕對位置用 pageX。

這些屬性難免仍有疏漏或未說清之處,遇到拿不到值的狀況,先確認文件模式,再考慮改用 window.innerWidth、scrollY、getBoundingClientRect() 這組現代 API,通常就能解決。

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