萬盛學電腦網

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

JavaScript 與 jQuery 獲取屏幕/視口/文檔尺寸完整速查表

前端開發中頻繁需要獲取各種尺寸:屏幕分辨率、瀏覽器可視區域、文檔實際大小、滾動偏移量等。原生 JS 與 jQuery 的 API 命名相似但含義不同,極易混淆。本文整理完整速查表,附帶可視化說明與實戰注意事項,助你精準獲取所需尺寸。

核心概念釐清

  • Screen(屏幕):用戶物理顯示器屬性,與瀏覽器窗口大小無關。
  • Window/Viewport(視口):瀏覽器內容渲染區域,不含工具欄、滾動條等瀏覽器 UI。
  • Document(文檔):整個 HTML 文檔的實際內容區域,可能大於視口導致滾動。
  • Element(元素):具體 DOM 節點的盒模型尺寸。

原生 JavaScript 尺寸屬性速查表

元素級屬性(以 document.body 為例)

屬性含義包含內容
clientWidth/Height可視區域尺寸內容 + padding,**不含** border、滾動條、margin
offsetWidth/Height佈局尺寸內容 + padding + border,**不含** margin
scrollWidth/Height完整內容尺寸內容實際大小(含被滾動隱藏部分)+ padding,**不含** border、margin
scrollLeft/Top滾動偏移量內容被卷去的水平/垂直距離

Window/Document 級屬性

屬性含義備註
window.innerWidth/Height視口尺寸含垂直滾動條寬度(若存在),**標準首選**
document.documentElement.clientWidth/Height視口尺寸不含滾動條,IE 標準模式下等同 innerWidth
document.body.clientWidth/HeightBody 可視尺寸怪異模式下生效,標準模式建議用 documentElement
window.scrollX / pageXOffset頁面水平滾動距離現代瀏覽器推薦 scrollX
window.scrollY / pageYOffset頁面垂直滾動距離現代瀏覽器推薦 scrollY
screen.width/height屏幕分辨率物理屏幕像素
screen.availWidth/Height屏幕可用工作區扣除任務欄等系統 UI
window.screenX/Y瀏覽器窗口相對屏幕位置原 screenLeft/Top 非標準

jQuery 尺寸方法速查表

方法對應原生含義包含內容
$(window).width()/height()window.innerWidth/Height視口尺寸不含滾動條
$(document).width()/height()document.documentElement.scrollWidth/Height文檔完整尺寸內容實際大小
$(element).width()/height()element.clientWidth/Height元素內容尺寸僅 content
$(element).innerWidth/Height()—元素內部尺寸content + padding
$(element).outerWidth/Height()element.offsetWidth/Height元素外部尺寸content + padding + border
$(element).outerWidth/Height(true)—元素完整外部尺寸content + padding + border + margin

實戰最佳實踐

1. 獲取視口尺寸(響應式佈局核心)

// 推薦:現代瀏覽器
const viewportWidth = window.innerWidth;
const viewportHeight = window.innerHeight;

// jQuery 等效
const vpW = $(window).width();
const vpH = $(window).height();

2. 判斷元素是否在視口內(懶加載/曝光埋點)

function isInViewport(el) {
  const rect = el.getBoundingClientRect();
  return (
    rect.top >= 0 &&
    rect.left >= 0 &&
    rect.bottom <= (window.innerHeight || document.documentElement.clientHeight) &&
    rect.right <= (window.innerWidth || document.documentElement.clientWidth)
  );
}

3. 獲取文檔總高度(無限滾動觸底判斷)

const docHeight = Math.max(
  document.body.scrollHeight,
  document.body.offsetHeight,
  document.documentElement.scrollHeight,
  document.documentElement.offsetHeight
);
const scrollTop = window.scrollY || document.documentElement.scrollTop;
const clientHeight = window.innerHeight || document.documentElement.clientHeight;

if (scrollTop + clientHeight >= docHeight - 50) {
  // 觸底加載更多
}

4. 元素相對文檔/視口位置

// 相對文檔(含滾動)
const { top, left } = element.getBoundingClientRect();
const docTop = top + window.scrollY;
const docLeft = left + window.scrollX;

// jQuery 等效
const offset = $(element).offset(); // { top, left } 相對文檔
const position = $(element).position(); // { top, left } 相對定位父元素

常見坑點提醒

  • DOCTYPE 缺失:觸發怪異模式,document.body 尺寸行為異常,**務必聲明 <!DOCTYPE html>**
  • CSS Box-sizing 影響:border-box 下 width/height 包含 padding/border,但 JS 尺寸 API 返回值不受其影響,始終基于 content-box 計算。
  • 縮放與高 DPI:window.devicePixelRatio > 1 時,CSS 像素 ≠ 物理像素,screen.width 返回物理像素,innerWidth 返回 CSS 像素。
  • 滾動條寬度差異:Windows 顯示滾動條(約 17px),macOS 默認隱藏,導致 innerWidth 與 clientWidth 差值不一致。

總結

掌握尺寸 API 的核心在於理解「盒模型層級」與「參考系」。日常開發中:

  • 視口尺寸 → window.innerWidth/Height 或 $(window).width/height()
  • 文檔尺寸 → $(document).width/height()
  • 元素佈局尺寸 → element.getBoundingClientRect()(最全面、高性能)
  • 滾動位置 → window.scrollX/Y

建議收藏本表,遇到尺寸問題查表對照,避免試錯浪費時間。

copyright © 萬盛學電腦網 all rights reserved