在前端開發中,精確掌握螢幕解析度、瀏覽器視窗大小以及網頁文件實際尺寸,是實現響應式佈局、彈窗定位、滾動監聽等核心功能的基礎。然而,JavaScript 提供了多組屬性(如 clientWidth、offsetWidth、scrollWidth、innerWidth 等),它們之間的差異、瀏覽器相容性問題,常讓開發者感到困惑。本文將系統整理這些屬性的定義、適用場景與跨瀏覽器最佳實踐,並附上可直接運行的完整代碼範例。
首先,我們釐清三組最常混淆的尺寸概念:
clientWidth / clientHeight — 內容區寬高 + padding,**不含** border、scrollbar、margin。offsetWidth / offsetHeight — 內容區寬高 + padding + border,**不含** margin。scrollWidth / scrollHeight — 實際內容完整寬高(包含被捲動隱藏的部分),**不含** border、margin。| 屬性 | 含義 | 典型用途 |
|---|---|---|
window.innerWidth / innerHeight | 瀏覽器視窗可視區域寬高(含捲軸) | 響應式斷點判斷、全屏組件高度計算 |
document.documentElement.clientWidth / clientHeight | 文件根元素可視區寬高(標準模式下等同視窗可視區,不含捲軸) | 最推薦的跨瀏覽器視窗尺寸獲取方式 |
window.screen.width / height | 螢幕物理解析度 | 統計用戶設備資訊 |
window.screen.availWidth / availHeight | 螢幕可用工作區寬高(扣除作業系統工具列) | 全屏網頁應用初始化尺寸 |
// 頁面已捲動距離(標準模式)
document.documentElement.scrollTop || document.body.scrollTop
document.documentElement.scrollLeft || document.body.scrollLeft
// 元素內部捲動
element.scrollTop, element.scrollLeft
事件物件提供多種座標,對應不同參考系:
clientX/Y:相對**視窗可視區**左上角(不隨捲動變化)。pageX/Y:相對**文件**左上角(含捲動距離)。screenX/Y:相對**螢幕**左上角。offsetX/Y:相對**觸發事件的目標元素**左上角(含 padding)。function getViewport() {
const w = window.innerWidth
|| document.documentElement.clientWidth
|| document.body.clientWidth;
const h = window.innerHeight
|| document.documentElement.clientHeight
|| document.body.clientHeight;
return { width: w, height: h };
}
在 **標準模式**(如 ``)下,`` 元素(`document.documentElement`)代表視窗可視區;在 **怪異模式** 下則由 `
` 代表。現代開發務必宣告標準模式,統一使用 `document.documentElement.clientWidth/Height`。<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>視窗尺寸即時監測</title>
<style>body{font-family:sans-serif;padding:20px;}</style>
</head>
<body>
<h2>當前視窗尺寸</h2>
<p>寬度: <span id="w"></span> px</p>
<p>高度: <span id="h"></span> px</p>
<script>
function update() {
const vp = getViewport();
document.getElementById('w').textContent = vp.width;
document.getElementById('h').textContent = vp.height;
}
window.addEventListener('resize', update);
update();
</script>
</body>
</html>
掌握這些屬性的邊界與差異,能讓你在處理複雜佈局、固定定位、虛擬滾動、Canvas/WebGL 畫布自適應等場景時遊刃有餘。