萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Iframe 自適應高度完整解決方案(含跨域處理)

Iframe 常用於嵌入第三方內容或模組化頁面,但固定高度易造成雙滾動條或內容截斷。本文提供三種主流自適應高度方案,涵蓋同域簡單實作、跨域 postMessage 通訊、以及傳統 document.domain 降域相容,並附上完整程式碼與注意事項。

方案一:同域環境下的直接存取

父頁面與 Iframe 同源(協議、域名、埠口相同),可直接讀取 iframe.contentDocument.body.scrollHeight。

父頁面 JavaScript

function setIframeHeight(iframe) {
  try {
    const doc = iframe.contentDocument || iframe.contentWindow.document;
    iframe.style.height = doc.documentElement.scrollHeight + 'px';
  } catch (e) {
    console.warn('同域高度獲取失敗', e);
  }
}

// 綁定 onload 確保內容已渲染
document.getElementById('myIframe').onload = function() {
  setIframeHeight(this);
};

Iframe 內頁面無需額外代碼

方案二:跨域環境 - postMessage 雙向通訊(推薦現代瀏覽器)

適用於不同域名、協議或埠口。父頁面監聽 message 事件,子頁面定期發送高度資訊。

父頁面

window.addEventListener('message', (e) => {
  // 安全性:驗證來源
  if (e.origin !== 'https://child.example.com') return;
  if (e.data && e.data.type === 'iframeResize') {
    document.getElementById('myIframe').style.height = e.data.height + 'px';
  }
});

子頁面(Iframe 內)

function sendHeight() {
  const height = document.documentElement.scrollHeight;
  parent.postMessage({ type: 'iframeResize', height }, 'https://parent.example.com');
}

// 頁面載入與內容變動時發送
window.addEventListener('load', sendHeight);
window.addEventListener('resize', sendHeight);
// 若內容動態變更(AJAX、Accordion),需手動呼叫 sendHeight()

方案三:傳統 document.domain 降域(僅限同主域名不同子域)

父頁面與子頁面同屬 example.com 下不同子域(如 a.example.com、b.example.com),可雙方設定 document.domain = 'example.com' 後按方案一直接存取。

// 父頁面與子頁面皆須在 script 執行早期設定
document.domain = 'example.com';

注意:瀏覽器正逐步棄用 document.domain,新專案請優先採用 postMessage。

常見坑點與最佳實踐

  • CSS 重置:Iframe 內頁面建議加上 body { margin: 0; } 避免邊距干擾高度計算。
  • 動態內容:AJAX 載入、圖片載入、手風琴展開等會改變高度,子頁面需主動通知父頁面(方案二)或父頁面輪詢(方案一)。
  • 滾動條閃爍:父頁面 Iframe 設定 scrolling="no" 或 CSS overflow: hidden。
  • 安全性:postMessage 必須驗證 e.origin,防止惡意注入。
  • 效能:避免高頻 postMessage,可使用 ResizeObserver(現代瀏覽器)監聽子頁面 body 尺寸變化。

完整範例下載

包含同域、跨域兩套完整可執行範例:GitHub Repo 連結

總結

Iframe 自適應高度的核心在於「子頁面知曉自身高度」與「父頁面安全接收高度」。現代專案首選 postMessage 方案,安全、跨域支援佳、擴充性高。搭配 ResizeObserver 可實現無感知的即時高度同步,徹底告別雙滾動條困擾。

copyright © 萬盛學電腦網 all rights reserved