取得視窗(容器)大小與位置的方法相當多,名稱又彼此相似,很容易混淆。以下分類列出並簡要說明。
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
有時會出現取不到值的情況,原因是 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;
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,通常就能解決。