萬盛學電腦網

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

JavaScript 檢測圖片尺寸防止大圖撐破頁面佈局

核心方案:onload 事件動態縮放

圖片加載完成後,檢查寬度是否超過容器最大寬度,超過則等比縮放或限制最大寬度。

原生 JS 實現

<script>
function limitImageWidth(img, maxWidth) {
  // img: HTMLImageElement
  // maxWidth: 數字,最大允許寬度(px)
  if (img.naturalWidth > maxWidth) {
    img.width = maxWidth; // 瀏覽器自動等比縮放高度
    // 或顯式設置高度:img.height = img.naturalHeight * (maxWidth / img.naturalWidth);
  }
}

// 用法:HTML 中直接綁定
// <img src="photo.jpg" onload="limitImageWidth(this, 500)">

// 批量處理頁面所有圖片
window.addEventListener('load', function() {
  var images = document.querySelectorAll('img[data-max-width]');
  images.forEach(function(img) {
    var max = parseInt(img.dataset.maxWidth, 10);
    if (!isNaN(max)) limitImageWidth(img, max);
  });
});
</script>

<!-- HTML -->
<img src="large.jpg" data-max-width="500" alt="自動限寬 500px">

jQuery 版本(項目已引用 jQuery 時)

$(function() {
  $('img[data-max-width]').each(function() {
    var $img = $(this);
    var max = parseInt($img.data('maxWidth'), 10);
    // 圖片可能已緩存,onload 不觸發,需手動檢查 complete
    if (this.complete) {
      checkAndLimit(this, max);
    } else {
      $img.one('load', function() { checkAndLimit(this, max); });
    }
  });

  function checkAndLimit(img, max) {
    if (img.naturalWidth > max) {
      $(img).css('width', max); // jQuery 自動處理單位
    }
  }
});

現代 CSS 方案(推薦:無 JS、性能最優)

<style>
/* 1. 最大寬度限制,等比縮放 */
img.responsive {
  max-width: 100%;      /* 不超過父容器 */
  height: auto;         /* 等比縮放 */
  display: block;       /* 去除底部間隙 */
}

/* 2. 固定寬度容器內的圖片 */
.container {
  width: 500px;         /* 容器固定寬 */
}
.container img {
  max-width: 100%;
  height: auto;
}

/* 3. object-fit: cover/contain (固定尺寸框內裁剪/填充) */
.thumb {
  width: 200px;
  height: 200px;
  overflow: hidden;
}
.thumb img {
  width: 100%;
  height: 100%;
  object-fit: cover;     /* 裁剪填滿 */
  /* object-fit: contain; 完整顯示,留白 */
}
</style>

進階:獲取真實尺寸的時機

避坑指南

  1. 緩存圖片不觸發 onload:必須檢查 img.complete 並手動調用處理函數。
  2. 圖片未加載時 naturalWidth 為 0:不要在 onload 前讀取。
  3. CSS max-width 失效:檢查父容器是否有具體寬度、圖片是否 display:inline 產生底部間隙(改 block)。
  4. 響應式圖片:優先用 <picture> + srcset + sizes 讓瀏覽器選擇最合適尺寸,避免下載過大原圖再縮放。

完整 Demo:JS 兜底 + CSS 主導

<!DOCTYPE html>
<html>
<head>
  <meta charset="UTF-8">
  <style>
    .article { max-width: 600px; margin: 20px auto; }
    .article img { max-width: 100%; height: auto; display: block; }
  </style>
</head>
<body>
  <article class="article">
    <img src="huge.jpg" alt="大圖" data-max-width="600">
  </article>

  <script>
  // 兜底:針對不支持 CSS max-width 的極舊瀏覽器(IE6-7)
  if (!('maxWidth' in document.documentElement.style)) {
    document.addEventListener('load', function(e) {
      if (e.target.tagName === 'IMG') {
        var max = parseInt(e.target.dataset.maxWidth, 10);
        if (max && e.target.naturalWidth > max) e.target.width = max;
      }
    }, true); // 捕獲階段,確保最先處理
  }
  </script>
</body>
</html>
copyright © 萬盛學電腦網 all rights reserved
屬性含義可用時機
img.width / img.height顯示尺寸 (CSS/屬性設置後)隨時
img.naturalWidth / img.naturalHeight圖片原始像素尺寸onload 後 (或 complete=true)
img.complete是否加載完成 (含緩存)隨時