做浮動層定位、判斷捲軸到底、置頂按鈕顯示時機,幾乎都會用到「寬高」。但 clientWidth、offsetWidth、scrollWidth 這三兄弟到底差在哪,是很多人一直沒搞清楚的問題。以下先給速查表,再逐一說明。
// —— 網頁可見區域 —— document.body.clientWidth // 可見區域寬(不含捲軸、不含邊框) document.body.clientHeight // 可見區域高 document.body.offsetWidth // 可見區域寬(含邊框,不含 margin) 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 // 可用工作區寬
記憶口訣:client 是「自己看到的」,offset 是「自己佔的」,scroll 是「內容實際的」。
clientWidth = 內容寬 + 左右 padding (不含 border、不含捲軸) offsetWidth = 內容寬 + padding + border + 捲軸 scrollWidth = 內容實際寬(若內容溢出,會大於 clientWidth)
用公式表示它們的關係:
offsetWidth = clientWidth + borderLeft + borderRight + scrollbarWidth scrollWidth = Math.max(clientWidth, 內容實際寬度)
實務上最常用的一句判斷「是否捲到底」正是利用這個關係:
if (document.documentElement.scrollTop + window.innerHeight
>= document.documentElement.scrollHeight) {
// 已經到底
}
這裡有個大坑:在標準模式下(有宣告 DOCTYPE)應讀 document.documentElement,在 quirks mode 下才讀 document.body。 直接讀 document.body.scrollTop 在 Chrome 上會永遠得到 0,很多人因此誤以為程式有錯。
相容寫法:
function getScrollTop() {
return window.pageYOffset
|| document.documentElement.scrollTop
|| document.body.scrollTop
|| 0;
}
function getViewportSize() {
return {
width: window.innerWidth || document.documentElement.clientWidth,
height: window.innerHeight || document.documentElement.clientHeight
};
}
常見困惑:螢幕是 1920px,但 document.body.clientWidth 只有 1909px。差的那 11px 就是垂直捲軸的寬度(Windows 上通常約 17px,扣除邊框後即為此值)。這也是為什麼做置中運算時,用 clientWidth 而非 screen.width 才不會偏。
除了 body,任何元素也都有這幾組:
clientTop / clientLeft —— 元素上邊框、左邊框的寬度(不是座標!)clientWidth / clientHeight —— 含 padding,不含 border 與捲軸offsetWidth / offsetHeight —— 含 padding、border、捲軸,回傳整數(四捨五入)scrollWidth / scrollHeight —— 內容實際尺寸,可搭配 scrollLeft / scrollTop 使用需要精確小數值時請用 getBoundingClientRect(),它回傳浮點數且不受四捨五入影響:
var rect = element.getBoundingClientRect(); console.log(rect.width, rect.height, rect.top, rect.left);
第一,offsetHeight 會四捨五入到整數,做像素級對齊時可能產生 1px 誤差,這時改用 getBoundingClientRect().height。
第二,元素若設為 display:none,所有尺寸都會是 0。需要先顯示(可用 visibility:hidden 佔位)再測量。
第三,圖片與 web font 載入完成後尺寸會改變,若在 DOMContentLoaded 就測量會得到錯誤值,應改在 window.onload 或圖片的 load 事件之後。
第四,window.screen 是螢幕的物理資訊,與視窗大小無關。使用者縮小瀏覽器視窗時 screen.width 完全不變,響應式設計必須用 window.innerWidth 或 matchMedia。