萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 獲取瀏覽器視窗、螢幕、文件尺寸完整速查表與跨瀏覽器相容實作

JS 尺寸屬性大全:clientWidth、offsetWidth、scrollWidth、screen、window 徹底搞懂

前端開發中頻繁需要獲取視窗、螢幕、文件、元素的各種寬高,但屬性眾多、瀏覽器差異大,極易混淆。本文系統整理所有相關屬性,提供跨瀏覽器相容的獲取函式,並附上可執行的即時測試頁面程式碼。

一、核心屬性分類速查表

對象屬性含義含邊框含滾動條含邊距
elementclientWidth/Height內容區 + padding否否否
offsetWidth/Height內容區 + padding + border是否否
scrollWidth/Height實際內容完整尺寸(含溢出隱藏部分)否否否
element 捲動scrollLeft/Top已捲動距離---
scrollLeft/Top = n設定捲動位置---
offsetLeft/Top相對 offsetParent 的偏移---
windowinnerWidth/Height視窗內部尺寸(含捲動條)-是-
outerWidth/Height瀏覽器視窗外部尺寸---
document.documentElementclientWidth/Height文件可視區尺寸(標準模式)-否-
scrollWidth/Height文件完整內容尺寸---
document.bodyclientWidth/Height文件可視區尺寸(怪異模式)-否-
scrollWidth/Height文件完整內容尺寸---
screenwidth/height螢幕解析度---
screenavailWidth/Height螢幕可用工作區(扣除工作列)---
eventclientX/Y相對視窗可視區的滑鼠座標---
eventpageX/Y相對文件的滑鼠座標(含捲動)---
eventoffsetX/Y相對目標元素的滑鼠座標---
eventscreenX/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}
}

五、IE 盒模型差異歷史補充(IE5/5.5 vs IE6+ 標準模式)

模式clientWidthoffsetWidth
標準模式 (IE6+/FF/Chrome)width + paddingwidth + padding + border
怪異模式 (IE5/5.5)width - borderwidth

現代開發務必宣告 <!DOCTYPE html> 強制標準模式,避免盒模型差異。

六、完整可執行測試頁面(複製存為 .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 效果。

收藏本文,下次遇到尺寸計算問題不再需要到處搜尋!

copyright © 萬盛學電腦網 all rights reserved