JavaScript 中涉及座標與尺寸的屬性眾多且瀏覽器差異大,本文系統整理 client、offset、scroll、screen 四大系列屬性,並深入分析 DOCTYPE 模式對佈局測量的影響,為前端開發提供權威參考。
| 系列 | 核心屬性 | 含義 | 包含內容 |
|---|---|---|---|
| client | clientWidth, clientHeight, clientLeft, clientTop | 可視區域尺寸 + 內邊距 | content + padding (無 border、scrollbar) |
| offset | offsetWidth, offsetHeight, offsetLeft, offsetTop, offsetParent | 元素佈局尺寸 + 邊框 | content + padding + border (無 margin) |
| scroll | scrollWidth, scrollHeight, scrollLeft, scrollTop | 實際內容完整尺寸 + 捲軸位置 | content + padding (含溢出內容) |
| screen | screen.width, screen.height, screen.availWidth, screen.availHeight | 螢幕/可用工作區尺寸 | 裝置物理像素 (不含作業系統工具列) |
// 視窗可視區域 (不含捲軸)
window.innerWidth / window.innerHeight // 標準模式
document.documentElement.clientWidth // 標準模式 (IE9+)
document.body.clientWidth // 相容模式
// 文檔完整尺寸
document.documentElement.scrollWidth // 標準模式
document.body.scrollWidth // 相容模式
// 捲軸位置
window.pageXOffset / window.pageYOffset // 標準 (IE9+)
document.documentElement.scrollLeft/Top // 標準模式
document.body.scrollLeft/Top // 相容模式
| 屬性 | 參考基準 | 用途 |
|---|---|---|
event.clientX/Y |
視窗可視區域左上角 | 定位浮層、Tooltip、右鍵選單 |
event.pageX/Y |
文檔左上角 (含捲軸) | 絕對定位、拖曳計算 |
event.screenX/Y |
螢幕左上角 | 多螢幕、視窗管理 |
event.offsetX/Y |
目標元素邊框內側左上角 | Canvas 繪圖、元素內部定位 |
event.layerX/Y |
當前定位父元素左上角 | Firefox 專屬,類似 offsetX |
這是最常被忽略卻導致嚴重 Bug 的根源:
| 模式 | DOCTYPE 宣告 | document.documentElement.clientWidth | document.body.clientWidth |
|---|---|---|---|
| 標準模式 | <!DOCTYPE html> 或 XHTML 1.0 Transitional |
視窗可視寬度 ✓ | body 元素寬度 |
| 相容模式 | 無 DOCTYPE 或舊版 DOCTYPE | 0 或異常值 ❌ | 視窗可視寬度 (IE) |
// IE6-10 標準模式
document.documentElement.clientWidth // 視窗可視寬度 ✓
document.body.clientWidth // body 寬度
// IE6-10 相容模式 (Quirks Mode)
document.documentElement.clientWidth // 0 ❌
document.body.clientWidth // 視窗可視寬度
// IE5.5 盒模型差異 (相容模式)
clientWidth = width - border // 標準是 width + padding
offsetWidth = width // 標準是 width + padding + border
var DomUtils = (function() {
// 獲取視窗可視尺寸
function getViewport() {
return {
width: window.innerWidth || document.documentElement.clientWidth || document.body.clientWidth,
height: window.innerHeight || document.documentElement.clientHeight || document.body.clientHeight
};
}
// 獲取文檔完整尺寸
function getDocumentSize() {
var doc = document.documentElement;
var body = document.body;
return {
width: Math.max(doc.scrollWidth, body.scrollWidth, doc.clientWidth, body.clientWidth),
height: Math.max(doc.scrollHeight, body.scrollHeight, doc.clientHeight, body.clientHeight)
};
}
// 獲取捲軸位置
function getScrollPosition() {
return {
x: window.pageXOffset || document.documentElement.scrollLeft || document.body.scrollLeft,
y: window.pageYOffset || document.documentElement.scrollTop || document.body.scrollTop
};
}
// 獲取元素相對文檔位置 (跨瀏覽器)
function getOffset(el) {
var rect = el.getBoundingClientRect();
var scroll = getScrollPosition();
return {
top: rect.top + scroll.y,
left: rect.left + scroll.x,
width: rect.width,
height: rect.height
};
}
// 獲取元素相對視窗位置
function getClientRect(el) {
return el.getBoundingClientRect();
}
return {
getViewport: getViewport,
getDocumentSize: getDocumentSize,
getScrollPosition: getScrollPosition,
getOffset: getOffset,
getClientRect: getClientRect
};
})();
// 使用範例
console.log('視窗:', DomUtils.getViewport());
console.log('文檔:', DomUtils.getDocumentSize());
console.log('捲軸:', DomUtils.getScrollPosition());
console.log('元素位置:', DomUtils.getOffset(document.getElementById('myDiv')));
function isElementInViewport(el) {
var rect = el.getBoundingClientRect();
return (
rect.top >= 0 &&
rect.left >= 0 &&
rect.bottom <= (window.innerHeight || document.documentElement.clientHeight) &&
rect.right <= (window.innerWidth || document.documentElement.clientWidth)
);
}
// IntersectionObserver 現代替代方案 (效能更好)
var observer = new IntersectionObserver(function(entries) {
entries.forEach(function(entry) {
if (entry.isIntersecting) {
console.log('元素進入視窗:', entry.target);
}
});
});
observer.observe(document.getElementById('watchTarget'));
window.addEventListener('scroll', function() {
var scrollPos = DomUtils.getScrollPosition();
var docSize = DomUtils.getDocumentSize();
var vpSize = DomUtils.getViewport();
// 觸發載入閾值:距離底部 200px
if (scrollPos.y + vpSize.height >= docSize.height - 200) {
loadMoreData();
}
}, { passive: true });
function updateStickyHeader() {
var header = document.getElementById('header');
var scrollY = DomUtils.getScrollPosition().y;
var headerHeight = header.offsetHeight;
if (scrollY > headerHeight) {
header.classList.add('fixed');
document.body.style.paddingTop = headerHeight + 'px'; // 防止內容跳動
} else {
header.classList.remove('fixed');
document.body.style.paddingTop = 0;
}
}
document.documentElement (標準模式),並提供 document.body 回退box-sizing: border-box 不影響 JS 屬性回傳值,offsetWidth 永遠包含 bordergetBoundingClientRect() 回傳縮放後像素,需除以 devicePixelRatio 換算邏輯像素掌握這套座標體系,能從容應對定位、捲動、響應式佈局、動畫交互等所有幾何計算需求。