DIV CSS 佈局教程網

iframe 父子頁面通訊:同域直接呼叫,跨域靠 hash 與代理 iframe
編輯:JavaScript綜合知識     

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 元素訪問

取得子視窗物件後,存取其中的 DOM 就跟操作同一頁面的元素沒有差別:

document.getElementById();
document.getElementsByName()[index];

// 實際例子
parent.window.document.getElementsByName("myFrame")[0];
myFrame.window.document.getElementById("button");

其中的 window 通常可以省略,寫成 parent.document...、myFrame.document... 亦可。

注意事項:務必等 iframe 載入完成

如果在 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 載入的是外部網站的頁面,基於安全機制,上面那套直接呼叫的方式就完全不能用了。此時有兩個經典技巧。

父頁面 → 子頁面:利用 location 的 hash

做法是改變 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(以下稱 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);

現代做法:postMessage

上面這套 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。少了這兩道驗證,等於把頁面的控制權開放給任何網站,是常見的安全漏洞來源。

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