做固定表頭、回到頂端按鈕、彈窗定位這類效果時,第一件要做的事就是把尺寸量出來。原生 JavaScript 提供了好幾組屬性,但它們的語意並不容易分辨,下面逐一釐清。
document.body.clientWidth // 可見區域寬 document.body.clientHeight // 可見區域高 document.body.offsetWidth // 可見區域寬(含邊線與 scrollbar) document.body.offsetHeight // 可見區域高(含邊線) document.body.scrollWidth // 正文全文寬 document.body.scrollHeight // 正文全文高 document.body.scrollTop // 被捲起的高度(Firefox 等) document.documentElement.scrollTop // 被捲起的高度(IE 等) document.body.scrollLeft // 被捲去的左側距離 window.screenTop // 正文部分距螢幕上方 window.screenLeft // 正文部分距螢幕左方
關鍵區別在於:client* 不含 border 與 scrollbar,offset* 含 border,scroll* 則是內容的完整尺寸(包含被捲走、目前看不到的部分)。判斷「有沒有出現捲軸」通常就是比較 scrollHeight 與 clientHeight。
obj.offsetWidth // 元素寬度 obj.offsetHeight // 元素高度 obj.offsetTop // 上邊界到 body 最頂部的距離(父容器不含 scrollbar 時) obj.offsetLeft // 左邊界到 body 最左側的距離(父容器不含 scrollbar 時)
若父容器含有 scrollbar,offsetTop/offsetLeft 回傳的會是「相對於直接父元素」的偏移量,而不是相對於 body。這個差異在巢狀結構中特別容易出錯,因此實務上若需要穩定取得元素在頁面上的絕對位置,通常會沿著 offsetParent 鏈逐層累加。
這兩個屬性用來「設定或取得」元素已經捲動的像素數。只有在元素真的出現捲軸時才有意義——例如 CSS 的 overflow 被設為 auto 或 scroll。它們通常定義在 <body> 或 <html> 上(究竟是哪一個,各瀏覽器實作不同),兩者搭配才能準確決定文件的捲動位置。
要特別注意的是,這些屬性不會反映 <iframe> 內部的捲動量。它們屬於非標準但支援度極高的屬性,跨瀏覽器時建議做特性偵測,例如同時嘗試 document.documentElement.scrollTop 與 document.body.scrollTop 並取有值者。
把這些屬性記成一組對照表最不容易出錯:想知道「使用者看得到多少」用 client*;想知道「元素實際佔多大」用 offset*;想知道「內容總共多長」用 scroll*。釐清這三組語意,絕大多數捲軸相關的版面問題都能定位。