DIV CSS 佈局教程網

IFrame 高度自適應:從 UA 判斷到 ResizeObserver 的演進
編輯:關於JavaScript     

讓 iframe 的高度自動符合內部內容,是一個反覆被提出的問題。它的標準答案隨時間變了幾次,本文按演進順序說明,最後給出目前該用的寫法。

一、早期解法:判斷瀏覽器再分別取值

function SetIFrameHeight(down) {
    var Sys = {};
    var ua = navigator.userAgent.toLowerCase();
    var s;

    (s = ua.match(/msie ([\d.]+)/))            ? Sys.ie      = s[1] :
    (s = ua.match(/firefox\/([\d.]+)/))        ? Sys.firefox = s[1] :
    (s = ua.match(/chrome\/([\d.]+)/))         ? Sys.chrome  = s[1] :
    (s = ua.match(/opera.([\d.]+)/))           ? Sys.opera   = s[1] :
    (s = ua.match(/version\/([\d.]+).*safari/)) ? Sys.safari  = s[1] : 0;

    var pTar = document.getElementById(down);
    pTar.style.display = "block";

    if (Sys.ie) {
        if (Sys.ie == '9.0') {
            pTar.height = pTar.contentWindow.document.body.offsetHeight + 15 + "px";
            pTar.width  = pTar.contentWindow.document.body.scrollWidth + "px";
        } else if (Sys.ie == '8.0') {
            pTar.height = pTar.Document.body.offsetHeight + 15 + "px";
            pTar.width  = pTar.Document.body.scrollWidth + "px";
        } else {
            pTar.height = pTar.Document.body.scrollHeight + 25 + "px";
            pTar.width  = pTar.Document.body.scrollWidth + "px";
        }
    }

    if (Sys.firefox) {
        pTar.height = pTar.contentDocument.body.offsetHeight + 15 + "px";
        pTar.width  = pTar.contentDocument.body.scrollWidth + "px";
    }

    if (Sys.chrome) {
        pTar.height = pTar.contentDocument.body.offsetHeight;
        pTar.width  = pTar.contentDocument.body.scrollWidth;
    }

    if (Sys.opera) {
        pTar.height = pTar.contentDocument.body.offsetHeight;
        pTar.width  = pTar.contentDocument.body.scrollWidth;
    }

    if (Sys.safari) {
        if (pTar.contentDocument.body.offsetHeight <= '186') {
            pTar.height = pTar.contentDocument.body.offsetHeight + 10;
        } else {
            pTar.height = pTar.contentDocument.body.offsetHeight;
        }
        pTar.width = pTar.contentDocument.body.scrollWidth;
    }
}

二、它其實只用了三種存取方式

看似五個分支,實際上 DOM 存取只有三種:

  • contentWindow.document —— IE9
  • Document(大寫 D)—— 舊 IE 的非標準屬性
  • contentDocument —— 標準,其餘全部適用

而 +15、+25、+10 以及 Safari 的 186 這個門檻,都是實測出來的補償值。它們綁定在特定瀏覽器版本上,任何一次更新都可能失準——這就是 UA 判斷法最根本的弱點。

三、四個結構性缺陷

  1. 只測量一次:iframe 內的圖片載入、字型套用、AJAX 填充、使用者展開摺疊,都會改變內容高度,而這個函數不會再跑。
  2. 跨來源直接失敗:不同網域時讀取 contentDocument 會因同源政策拋出安全性例外。
  3. UA 已不可靠:Edge 自 v79 起 UA 中同時含有 "Edg" 與 "Chrome",Safari 的 UA 也含有 "Safari" 而 Chrome 同樣含有,單純的 indexOf 判斷早已亂成一團。
  4. 順便設了 width:讓 iframe 寬度貼合內容通常造成版面問題,正常做法是寬度填滿容器、只自動調高度。

四、同源情境:直接測量即可

function fitIframe(iframe) {
    try {
        var doc  = iframe.contentDocument || iframe.contentWindow.document;
        var b    = doc.body;
        var html = doc.documentElement;

        // 取最大值,避免 body 與 html 不一致時被裁切
        var h = Math.max(
            b.scrollHeight, b.offsetHeight,
            html.clientHeight, html.scrollHeight, html.offsetHeight
        );
        iframe.style.height = h + "px";
    } catch (e) {
        console.warn("無法調整(可能為跨來源)", e);
    }
}

最可靠的方式是由 iframe 內部主動通知父頁,因為內部隨時知道自己的尺寸:

// 放在 iframe 內部的頁面中
function notify() {
    parent.postMessage({
        type: "iframe-height",
        height: Math.max(document.body.scrollHeight,
                         document.documentElement.scrollHeight)
    }, "https://parent.example.com");     // 明確指定目標來源
}

window.addEventListener("load", notify);
new ResizeObserver(notify).observe(document.body);   // 內容變動時自動通知

父頁面的接收端:

window.addEventListener("message", function (e) {
    if (e.origin !== "https://child.example.com") return;   // 必須驗證!
    if (e.data && e.data.type === "iframe-height") {
        document.getElementById("myFrame").style.height = e.data.height + "px";
    }
});

origin 驗證是必要的安全措施。缺少它,任何網站都能對你的頁面發送訊息、操控 iframe 尺寸,甚至觸發其他綁定在同一監聽器上的行為。同樣地,發送端也應指定明確的 targetOrigin,而非使用 "*"。

五、幾個實務細節

  • iframe 內的 body 不要設 overflow:hidden,否則內容超出時高度不會反映真實需求。
  • 圖片請加上 width/height 屬性或 CSS aspect-ratio,避免載入前後高度跳動導致 ResizeObserver 觸發多次。
  • 若內容高度會劇烈變化(例如展開一個長列表),可對高度套用 CSS transition: height .2s 讓變化柔和一些。
  • 行動裝置的位址列會動態收合,100vh 的行為與桌面不同,高度計算上要留意。

六、值得先問的一句話

如果 iframe 的內容也是你自己的,那麼 iframe 帶來的成本往往不值得:多一次請求、樣式無法共用、SEO 不友善、鍵盤焦點與無障礙樹被隔離、行動裝置高度計算麻煩。

改用 AJAX 抓取 HTML 片段後插入,或直接用前端框架的元件,通常能得到更好的結果。iframe 真正不可替代的場合是:嵌入第三方內容、需要嚴格的樣式與腳本隔離、或沙箱化執行不受信任的內容。若只是因為「模組化比較方便」,那麼有更好的工具可用。

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