iframe 內的頁面要與外層頁面溝通,方式取決於兩者是否同網域。同域時可以直接呼叫彼此的方法、互訪 DOM;跨域時則受同源政策限制,需要借助一些技巧繞道。本文分兩部分說明。
父頁面 parent.html:
<html>
<head>
<script type="text/javascript">
function say() {
alert("parent.html------>I'm at parent.html");
}
function callChild() {
// document.frames["myFrame"].window.say(); // 僅適用於 IE
myFrame.window.say();
myFrame.window.document.getElementById("button").value = "我變了";
}
</script>
</head>
<body>
<input type="button" value="調用 child.html 中的函式 say()"
onclick="callChild()">
<iframe name="myFrame" src="child.html"></iframe>
</body>
</html>
子頁面 child.html:
<html>
<head>
<script type="text/javascript">
function say() {
alert("child.html--->I'm at child.html");
}
function callParent() {
parent.say();
parent.window.document.getElementsByName("myFrame")[0].style.height = "100px";
}
</script>
</head>
<body>
<input id="button" type="button" value="調用 parent.html 中的 say() 函式"
onclick="callParent()">
</body>
</html>
父呼叫子:FrameName.window.childMethod();(這種寫法相容於各瀏覽器)
子呼叫父:parent.window.parentMethod();
取得子視窗物件後,存取其中的 DOM 就跟操作同一頁面的元素沒有差別:
document.getElementById();
document.getElementsByName()[index];
// 實際例子
parent.window.document.getElementsByName("myFrame")[0];
myFrame.window.document.getElementById("button");
其中的 window 通常可以省略,寫成 parent.document...、myFrame.document... 亦可。
如果在 iframe 尚未載入完成時就呼叫裡面的方法或變數,會因為找不到該物件而報錯。判斷是否載入完畢有兩種方式:
一是在 iframe 標籤上使用 onload 事件;
二是檢查 document.readyState == "complete"。
var frame = document.getElementById('myFrame');
frame.addEventListener('load', function () {
// 這裡才安全
frame.contentWindow.childMethod();
});
順帶一提,標準寫法是透過 contentWindow 或 contentDocument 取得 iframe 的視窗/文件物件,比直接用 name 當全域變數更可靠——後者 depends on 瀏覽器把 name 掛上 window 的非標準行為。
如果 iframe 載入的是外部網站的頁面,基於安全機制,上面那套直接呼叫的方式就完全不能用了。此時有兩個經典技巧。
做法是改變 iframe 的 src,在網址後加上 # 與要傳遞的資料。因為 hash 部分不會被送到伺服器,也不會觸發頁面重新載入,所以是相當安全的傳值通道。
子頁面則用 setInterval 定時檢查 location.href 的變化,一旦偵測到 hash 改變,就能讀取並處理這段資料:
// 父頁面
var frame = document.getElementById('myFrame');
frame.src = frame.src.split('#')[0] + '#data=' + encodeURIComponent(msg);
// 子頁面
setInterval(function () {
var hash = location.hash;
if (hash && hash !== lastHash) {
lastHash = hash;
var data = decodeURIComponent(hash.substring(1));
// 依 data 進行後續處理
}
}, 300);
反方向的傳遞較為曲折,做法是在子頁面中再嵌一個代理 iframe(以下稱 iframe C),這個 iframe C 必須與主頁面同域。
於是可以拆成兩段:子頁面先把資料透過上述 hash 方式傳給同域的 iframe C;由於 iframe C 與主頁面同域,第二段就退化回「同域通訊」問題,可以直接用 window.top(或 window.parent.parent)取得最上層視窗物件,呼叫主頁面的方法完成傳遞。
// 在子頁面中,把資料交給同域代理 iframe
document.getElementById('proxy').src = 'proxy.html#' + encodeURIComponent(msg);
// proxy.html(與主頁面同域)
window.addEventListener('message', function () { /* ... */ });
// 或直接在自身載入時讀 hash 並轉交
var data = decodeURIComponent(location.hash.substring(1));
window.top.receiveFromFrame(data);
上面這套 hash 加代理 iframe 的設計,是為了在 postMessage 問世之前繞過同源政策。如今所有主流瀏覽器都支援 postMessage,它天生就是為跨域視窗通訊而設計,無論同域或跨域都能用同一套 API:
// 父頁面:傳給 iframe
document.getElementById('myFrame').contentWindow.postMessage(
{ type: 'set-height', value: 200 },
'https://child.example.com' // 明確指定目標來源
);
// 父頁面:接收子頁面的訊息
window.addEventListener('message', function (event) {
if (event.origin !== 'https://child.example.com') return; // 務必驗證來源
if (event.data && event.data.type === 'child-ready') {
// 處理訊息
}
});
// 子頁面:傳回父頁面
window.parent.postMessage({ type: 'child-ready' }, 'https://parent.example.com');
使用 postMessage 有兩個不可省略的步驟:送出時明確指定 targetOrigin(不要用 *),接收時務必檢查 event.origin。少了這兩道驗證,等於把頁面的控制權開放給任何網站,是常見的安全漏洞來源。