DIV CSS 佈局教程網

JS 取得 DOM 寬高的完整對照表:clientWidth、scrollWidth、offsetWidth 全解析
編輯:關於JavaScript     

做浮動層定位、判斷捲軸到底、置頂按鈕顯示時機,幾乎都會用到「寬高」。但 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     // 可用工作區寬

二、三個 Width 的關係

記憶口訣: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) {
    // 已經到底
}

三、body 與 documentElement 的選擇

這裡有個大坑:在標準模式下(有宣告 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
    };
}

四、clientWidth 與螢幕寬度為什麼不相等

常見困惑:螢幕是 1920px,但 document.body.clientWidth 只有 1909px。差的那 11px 就是垂直捲軸的寬度(Windows 上通常約 17px,扣除邊框後即為此值)。這也是為什麼做置中運算時,用 clientWidth 而非 screen.width 才不會偏。

五、Element 節點上的四組屬性

除了 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。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved