頁面裡嵌 iframe 時,最惱人的就是高度——內容多了出現內層捲軸,內容少了下方留一大塊空白。理想狀態是讓 iframe 隨內容自動伸縮,而這件事出乎意料地簡單。
典型情境是:iframe 裡嵌入一個列表頁面。新增資料後重整列表,iframe 應該自動變高;刪除資料後,則該自動縮短。若高度固定,前者會出現雙重捲軸(外層頁面一個、內層 iframe 一個),後者會留下難看的空白。
把這段放到 被嵌入的那個頁面(也就是 iframe 內部載入的 html 或 jsp),在 </html> 之後呼叫即可:
<script type="text/javascript">
// 自動調整 iframe 的高度,自適應內容的展開與收縮
function autoAdjustWindow() {
try {
window.frameElement.height = document.body.scrollHeight;
window.frameElement.parentElement.height = document.body.scrollHeight;
window.frameElement.width = document.body.scrollWidth;
window.frameElement.parentElement.width = document.body.scrollWidth;
} catch (e) {}
}
</script>
<script type="text/javascript">
autoAdjustWindow();
</script>
關鍵是 window.frameElement——這個屬性指向「承載當前視窗的那個 iframe 元素」。也就是說,被嵌入的頁面可以自己回頭去改外層的 iframe 尺寸,不需要外層頁面寫任何程式。這是這個方案最優雅的地方。
document.body.scrollHeight 是 body 的完整內容高度(包含未被捲動遮住的溢出部分),把它寫給 frameElement 的 height,iframe 就正好包住內容。
程式碼同時設定了 frameElement 與它的 parentElement,是為了相容某些瀏覽器需要改父容器才生效的情況。
1. 只能同域使用。window.frameElement 受 same-origin policy 保護。若 iframe 載入的是跨域內容,存取它會拋出安全性錯誤——這也是範例用 try/catch 包住的原因。跨域情境需要雙方配合,用 postMessage 溝通:
// 內層頁面(被嵌入方)
window.parent.postMessage({ type: 'resize', height: document.body.scrollHeight }, '*');
// 外層頁面
window.addEventListener('message', function (e) {
if (e.data && e.data.type === 'resize') {
document.getElementById('myframe').style.height = e.data.height + 'px';
}
});
使用 postMessage 時,'*' 應替換為明確的來源網域,並在接收端驗證 e.origin,否則任何網站都能控制你的頁面佈局。
2. 內容必須在呼叫時已經完全渲染。若圖片尚未載入完成,此時量到的高度會偏小,圖片載入後撐開就會被裁切。因此建議在 load 事件(而非 DOMContentLoaded)後呼叫,並用 ResizeObserver 持續監聽:
new ResizeObserver(function () {
window.frameElement.height = document.body.scrollHeight + 'px';
}).observe(document.body);
這樣無論內容如何動態變化(新增列表項、展開收合、圖片載入),高度都會自動跟上,不必手動定時重算。
iframe 自動伸縮很方便,但有幾個副作用值得注意:高度完全由內容決定時,外層頁面會變得非常長,這在行動裝置上可能不是好體驗;某些廣告或統計程式會因 iframe 高度頻繁變動而誤判;另外,頻繁的 resize 會觸發外層頁面的重排,若內容變化劇烈建議加上 debounce。若專案允許,直接放棄 iframe、用前端元件或 Server-side include 組合頁面,通常會比對抗 iframe 的限制更輕鬆。