做置中彈窗、自適應版面、Canvas 縮放,都離不開「取得尺寸」這件事。本文整理所有相關屬性的意義、跨瀏覽器差異,並附一個可即時顯示數值的範例。
網頁可見區域寬:document.body.clientWidth
網頁可見區域高:document.body.clientHeight
網頁可見區域寬:document.body.offsetWidth(含邊線)
網頁可見區域高:document.body.offsetHeight(含邊線)
網頁正文全文寬:document.body.scrollWidth
網頁正文全文高:document.body.scrollHeight
網頁被捲去的高:document.body.scrollTop
網頁被捲去的左:document.body.scrollLeft
網頁正文部分上:window.screenTop
網頁正文部分左:window.screenLeft
螢幕解析度的高:window.screen.height
螢幕解析度的寬:window.screen.width
螢幕可用工作區高度:window.screen.availHeight
螢幕可用工作區寬度:window.screen.availWidth
scrollHeight:物件的滾動高度(含未顯示部分)
scrollLeft:設定或取得左邊界與目前可見內容最左端的距離
scrollTop:設定或取得頂端與可見內容最頂端的距離
scrollWidth:物件的滾動寬度
offsetHeight:相對版面或 offsetParent 指定父座標的高度
offsetLeft:相對版面或 offsetParent 的計算左側位置
offsetTop:相對版面或 offsetParent 的計算頂端位置
event.clientX/clientY:相對文件(視窗)的水平/垂直座標
event.offsetX/offsetY:相對目標容器的座標
document.documentElement.scrollTop:垂直方向的滾動值
event.clientX + document.documentElement.scrollTop:相對文件的絕對垂直位置
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 皆無關。)
這組差異源自 IE5 的著名 box model bug,IE6 之後只有在 quirks mode 下才會重現,因此頁面上宣告 <!DOCTYPE html> 是避免這類計算錯亂的關鍵。
不同瀏覽器取得視窗尺寸的方式不同:Netscape 系用 window.innerWidth/innerHeight;IE 需深入 document 對 body 檢測;在 DOM 標準環境下則要注意根元素(documentElement)而非 body。document.body.clientHeight 代表目前視窗高度,documentElement 則是 HTML 文件的根節點。
<h2 align="center">請調整浏覽器窗口大小</h2><hr>
<form action="#" method="get" name="form1" id="form1">
浏覽器窗口的實際高度: <input type="text" name="availHeight" size="4"><br>
浏覽器窗口的實際寬度: <input type="text" name="availWidth" size="4"><br>
</form>
<script type="text/javascript">
var winWidth = 0;
var winHeight = 0;
function findDimensions()
{
if (window.innerWidth)
winWidth = window.innerWidth;
else if ((document.body) && (document.body.clientWidth))
winWidth = document.body.clientWidth;
if (window.innerHeight)
winHeight = window.innerHeight;
else if ((document.body) && (document.body.clientHeight))
winHeight = document.body.clientHeight;
if (document.documentElement && document.documentElement.clientHeight && document.documentElement.clientWidth)
{
winHeight = document.documentElement.clientHeight;
winWidth = document.documentElement.clientWidth;
}
document.form1.availHeight.value= winHeight;
document.form1.availWidth.value= winWidth;
}
findDimensions();
window.onresize=findDimensions;
</script>
程式先建立一個含兩個文本框的表單,用來即時顯示視窗寬高。接著定義 winWidth、winHeight 保存數值,在 findDimensions() 中依序嘗試 window.innerXXX → document.body.clientXXX → document.documentElement.clientXXX 三種來源(後者優先,因為它最貼近標準),最後透過表單名稱存取元素輸出結果,並以 window.onresize 掛上監聽。
這套多層 fallback 在今天已無必要,直接用標準 API 即可:
// 視窗可視尺寸(不含捲動條的判斷請留意)
const w = window.innerWidth;
const h = window.innerHeight;
// 文件整體尺寸
const docW = document.documentElement.scrollWidth;
// 螢幕
const screenW = window.screen.width;
要監聽尺寸變化,window.onresize 會在拖曳視窗時高頻觸發,容易卡頓;改用 ResizeObserver 針對特定元素、或以 requestAnimationFrame/debounce 節流。
純 CSS 需求則首選 vw、vh、dvh 單位與 media query,不必寫 JS。
最後提醒:讀取 offsetWidth、scrollTop 這類屬性會觸發強制同步 reflow,在迴圈或動畫中反覆存取是常見的效能殺手。能快取就快取,並盡量把讀取與寫入分批處理。