萬盛學電腦網

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

基於 jQuery 實現圖片自動縮放與裁剪(兼容緩存與非緩存情況)

需求背景

門戶類網站常包含大量不同尺寸的圖片。為保持頁面美觀,通常要求圖片按固定比例顯示。然而編輯人員上傳的圖片尺寸往往不統一,若直接用 CSS 強制拉伸會導致變形。本文提供一套基於 jQuery 的解決方案:頁面加載後自動判斷圖片原始尺寸與顯示區域比例,按比例縮放並居中裁剪,同時完美處理圖片已緩存與未緩存兩種情況。

核心思路

  1. CSS 預定義顯示尺寸:為圖片容器設定固定寬高,JS 未執行時顯示拉伸圖片(降級方案)。
  2. 引入裁剪容器:為每個圖片顯示區域額外定義一個容器(示例使用 `` 標籤),樣式與圖片容器一致,並設定 `overflow: hidden` 實現裁剪效果。
  3. 比例計算與縮放:對比原始圖片與顯示區域的長寬比,按比例縮放圖片使其完全填滿顯示區域(長邊對齊,短邊超出)。
  4. 動態包裹:將處理後的圖片用 `` 包裹,利用容器的 `overflow: hidden` 隱藏超出部分。
  5. 緩存兼容處理:遍歷圖片時,先檢測 `image.complete` 判斷是否已緩存。已緩存直接處理;未緩存則綁定 `onload` 事件,確保獲取到真實尺寸。

完整代碼實現

1. CSS 樣式

/* 通用裁剪容器樣式 */
cite {
    display: block;
    overflow: hidden;
    overflow: hidden !important; /* 強制覆蓋 */
}

/* 具體圖片容器樣式(示例) */
#BigPic img {
    display: block;
    padding: 2px;
    width: 240px;
    height: 160px;
    border: 1px solid #cccccc;
}
#BigPic cite {
    display: block;
    padding: 2px;
    width: 240px;
    height: 160px;
    border: 1px solid #cccccc;
}
#BigPic cite img {
    display: block;
    margin: 0;
    padding: 0;
    border: none;
}

2. 圖片處理核心函數

/**
 * 圖片尺寸判斷與裁剪處理
 * @param {HTMLImageElement} obj - 目標圖片 DOM 元素
 */
function cutImgz(obj) {
    var image = new Image();
    image.src = obj.src;
    var $this = $(obj);

    // 獲取 CSS 定義的顯示寬高
    var iwidth = $this.width();
    var iheight = $this.height();

    // 若原始比例與顯示比例不一致,則進行處理
    if (1 * image.width * iheight != 1 * iwidth * image.height) {
        // 原始圖較寬(或等寬):以高度為基準縮放,寬度超出部分被裁剪
        if (image.width / image.height >= iwidth / iheight) {
            $this.height(iheight + 'px');
            $this.width((image.width * iheight) / image.height + 'px');
        }
        // 原始圖較高:以寬度為基準縮放,高度超出部分被裁剪
        else {
            $this.width(iwidth + 'px');
            $this.height((image.height * iwidth) / image.width + 'px');
        }

        // 用 cite 包裹實現裁剪
        $this.wrap('');
    }
}

3. 頁面加載時的遍歷與綁定邏輯

$(function() {
    $('img').each(function() {
        var image = new Image();
        image.src = this.src;

        if (image.complete) {
            // 圖片已在緩存中,立即處理
            cutImgz(this);
        } else {
            // 圖片未緩存,等待 onload 觸發
            this.onload = function() {
                cutImgz(this);
            };
        }
    });
});

關鍵點解析

為何要判斷 `image.complete`?

  • 已緩存圖片:瀏覽器會極快完成載入,若在綁定 `onload` 前已載入完畢,`onload` 事件將不會觸發,導致處理邏輯失效。
  • 未緩存圖片:若直接處理,`new Image()` 的 `width`/`height` 為 0,無法計算比例。必須等待 `onload` 後再處理。

為何使用 `` 而非 `
`?

單純為了避免與常規佈局標籤衝突,`` 語義上表示引用/標題,樣式重置後作為無語義的裁剪容器極合適。實際項目中可改用 `` 或 `

` 並加專用 class。

擴展建議

  • 將固定尺寸改為 data 屬性(如 `data-width="240" data-height="160"`),JS 讀取屬性而非硬編碼 CSS,提高復用性。
  • 對於響應式佈局,可在 `window.resize` 事件中重新計算並調用 `cutImgz`(需先解除之前的 `wrap`)。
  • 現代瀏覽器可考慮純 CSS 方案:`object-fit: cover` + `object-position: center`,無需 JS,但兼容性需評估(IE 不支持)。
copyright © 萬盛學電腦網 all rights reserved