前端開發中頻繁需要獲取視窗、螢幕、文件、元素的各種寬高,但屬性眾多、瀏覽器差異大,極易混淆。本文系統整理所有相關屬性,提供跨瀏覽器相容的獲取函式,並附上可執行的即時測試頁面程式碼。
| 對象 | 屬性 | 含義 | 含邊框 | 含滾動條 | 含邊距 |
|---|---|---|---|---|---|
element | clientWidth/Height | 內容區 + padding | 否 | 否 | 否 |
offsetWidth/Height | 內容區 + padding + border | 是 | 否 | 否 | |
scrollWidth/Height | 實際內容完整尺寸(含溢出隱藏部分) | 否 | 否 | 否 | |
element 捲動 | scrollLeft/Top | 已捲動距離 | - | - | - |
scrollLeft/Top = n | 設定捲動位置 | - | - | - | |
offsetLeft/Top | 相對 offsetParent 的偏移 | - | - | - | |
window | innerWidth/Height | 視窗內部尺寸(含捲動條) | - | 是 | - |
outerWidth/Height | 瀏覽器視窗外部尺寸 | - | - | - | |
document.documentElement | clientWidth/Height | 文件可視區尺寸(標準模式) | - | 否 | - |
scrollWidth/Height | 文件完整內容尺寸 | - | - | - | |
document.body | clientWidth/Height | 文件可視區尺寸(怪異模式) | - | 否 | - |
scrollWidth/Height | 文件完整內容尺寸 | - | - | - | |
screen | width/height | 螢幕解析度 | - | - | - |
screen | availWidth/Height | 螢幕可用工作區(扣除工作列) | - | - | - |
event | clientX/Y | 相對視窗可視區的滑鼠座標 | - | - | - |
event | pageX/Y | 相對文件的滑鼠座標(含捲動) | - | - | - |
event | offsetX/Y | 相對目標元素的滑鼠座標 | - | - | - |
event | screenX/Y | 相對螢幕的滑鼠座標 | - | - | - |
/**
* 取得視窗可視寬高(不含捲動條)
* @returns {{width: number, height: number}}
*/
function getViewportSize() {
// 標準模式優先 documentElement,怪異模式 fallback body
var docEl = document.documentElement;
var body = document.body;
var width = window.innerWidth || docEl.clientWidth || body.clientWidth;
var height = window.innerHeight || docEl.clientHeight || body.clientHeight;
return { width, height };
}
// 即時監聽視窗縮放
window.addEventListener('resize', function () {
var size = getViewportSize();
console.log('視窗尺寸:', size.width, 'x', size.height);
// 同步更新 UI ...
});
function getDocumentSize() {
var docEl = document.documentElement;
var body = document.body;
return {
width: Math.max(docEl.scrollWidth, body.scrollWidth, docEl.clientWidth),
height: Math.max(docEl.scrollHeight, body.scrollHeight, docEl.clientHeight)
};
}
// 取得元素相對文件左上角座標(支援巢狀、transform、fixed)
function getElementOffset(el) {
var rect = el.getBoundingClientRect();
var scrollLeft = window.pageXOffset || document.documentElement.scrollLeft;
var scrollTop = window.pageYOffset || document.documentElement.scrollTop;
return {
left: rect.left + scrollLeft,
top: rect.top + scrollTop,
width: rect.width,
height: rect.height
};
}
// 相對視窗座標(不含捲動)
function getElementClientRect(el) {
return el.getBoundingClientRect(); // {left, top, right, bottom, width, height}
}
| 模式 | clientWidth | offsetWidth |
|---|---|---|
| 標準模式 (IE6+/FF/Chrome) | width + padding | width + padding + border |
| 怪異模式 (IE5/5.5) | width - border | width |
現代開發務必宣告 <!DOCTYPE html> 強制標準模式,避免盒模型差異。
<!DOCTYPE html>
<html><head><meta charset="utf-8"><title>JS 尺寸屬性即時測試</title>
<style>
body { font-family: sans-serif; padding: 20px; max-width: 800px; margin: 0 auto; }
.panel { border: 2px solid #333; padding: 15px; margin: 10px 0; background: #fafafa; }
.row { display: flex; margin: 5px 0; }
.label { width: 280px; font-weight: bold; color: #333; }
.value { font-family: monospace; color: #0066cc; }
button { padding: 8px 16px; margin-right: 10px; cursor: pointer; }
</style></head><body>
<h1>JavaScript 尺寸屬性即時測試</h1>
<p>調整瀏覽器視窗大小、捲動頁面,觀察數值變化。</p>
<div class="panel">
<h2>Window / Screen</h2>
<div class="row"><span class="label">window.innerWidth / innerHeight</span><span class="value" id="vw"></span></div>
<div class="row"><span class="label">screen.width / height</span><span class="value" id="sw"></span></div>
<div class="row"><span class="label">screen.availWidth / availHeight</span><span class="value" id="saw"></span></div>
</div>
<div class="panel">
<h2>Document / Body</h2>
<div class="row"><span class="label">documentElement.clientWidth/Height</span><span class="value" id="dec"></span></div>
<div class="row"><span class="label">documentElement.scrollWidth/Height</span><span class="value" id="des"></span></div>
<div class="row"><span class="label">body.clientWidth/Height</span><span class="value" id="bc"></span></div>
<div class="row"><span class="label">body.scrollWidth/Height</span><span class="value" id="bs"></span></div>
<div class="row"><span class="label">documentElement.scrollTop/Left</span><span class="value" id="dest"></span></div>
</div>
<div class="panel">
<h2>Event 座標(在下方區域移動滑鼠)</h2>
<div id="mouse-area" style="width:100%; height:200px; background:#eef; border:2px dashed #99c;"></div>
<div class="row"><span class="label">event.clientX / clientY</span><span class="value" id="ec"></span></div>
<div class="row"><span class="label">event.pageX / pageY</span><span class="value" id="ep"></span></div>
<div class="row"><span class="label">event.offsetX / offsetY</span><span class="value" id="eo"></span></div>
<div class="row"><span class="label">event.screenX / screenY</span><span class="value" id="es"></span></div>
</div>
<script>
function updateAll() {
var v = getViewportSize();
$('#vw').text(v.width + ' x ' + v.height);
$('#sw').text(screen.width + ' x ' + screen.height);
$('#saw').text(screen.availWidth + ' x ' + screen.availHeight);
$('#dec').text(document.documentElement.clientWidth + ' x ' + document.documentElement.clientHeight);
$('#des').text(document.documentElement.scrollWidth + ' x ' + document.documentElement.scrollHeight);
$('#bc').text(document.body.clientWidth + ' x ' + document.body.clientHeight);
$('#bs').text(document.body.scrollWidth + ' x ' + document.body.scrollHeight);
$('#dest').text(document.documentElement.scrollTop + ' / ' + document.documentElement.scrollLeft);
}
function getViewportSize() {
var docEl = document.documentElement, body = document.body;
return { width: window.innerWidth || docEl.clientWidth || body.clientWidth,
height: window.innerHeight || docEl.clientHeight || body.clientHeight };
}
$(function () {
updateAll();
$(window).on('resize scroll', updateAll);
$('#mouse-area').on('mousemove', function (e) {
$('#ec').text(e.clientX + ' / ' + e.clientY);
$('#ep').text(e.pageX + ' / ' + e.pageY);
$('#eo').text(e.offsetX + ' / ' + e.offsetY);
$('#es').text(e.screenX + ' / ' + e.screenY);
});
});
</script>
</body></html>
rect.top < viewportHeight && rect.bottom > 0(IntersectionObserver 更佳)。scrollTop + clientHeight >= scrollHeight - threshold。left: (vw - elWidth)/2 + scrollLeft。offsetTop < scrollTop 觸發 sticky 效果。收藏本文,下次遇到尺寸計算問題不再需要到處搜尋!