DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> HTML基礎知識 >> HTML5詳解
HTML5 跨文件通訊實作:postMessage 與 message 事件詳解
編輯:HTML5詳解     

HTML5 提供的跨文件消息傳輸(Cross-document messaging)機制,讓不同來源、彼此隔離的視窗與 iframe 之間可以安全地交換訊息。核心只有兩個 API:接收端監聽 window 的 message 事件,發送端呼叫 postMessage()。

接收訊息:監聽 message 事件

window.addEventListener("message", function (event) {
  // 在這裡處理收到的訊息
}, false);

發送訊息:postMessage()

otherWindow.postMessage(message, targetOrigin);

這個方法有兩個參數。第一個參數是要傳送的內容,可以是字串,也可以是任何 JavaScript 物件(透過 JSON 在物件與文字之間轉換)。第二個參數是接收方視窗的 URL;字串中可以使用萬用字元「*」放寬比對,但實務上強烈建議填入精確的 URL,以避免訊息外洩。

其中 otherWindow 是目標視窗物件的參照,取得方式有兩種:由 window.open() 的回傳值取得,或透過 window.frames 陣列以索引(index)或名稱取出單一 frame 所屬的視窗物件。

完整示例

主頁面

<!DOCTYPE Html>
<Html>
<head>
<meta charset="UTF-8"/>
<title>跨文件消息傳輸示例主文檔</title>
<script type="text/Javascript" src="https://code.jquery.com/jquery-1.6.4.min.js"></script>
<script type="text/Javascript">
$(function() {
  // 監聽 message 事件
  window.addEventListener("message", function(event) {
    // 忽略指定 URL 之外的頁面送來的消息
    if (event.origin != "https://www.blue-butterfly.Net") return;
    alert(event.data); // 顯示消息
  }, false);

  $("#iframeContent").load(function(event) {
    // 向子頁面發送消息
    this[0].postMessage("Hello", "https://www.blue-butterfly.Net/test/");
  });
});
</script>
</head>
<body>
<header>
<h1>跨域通信示例</h1>
</header>
<iframe id="iframeContent" width="400" src="https://www.blue-butterfly.Net/test/"></iframe>
</body>
</Html>

子頁面(iframe 內容)

<!DOCTYPE Html>
<Html>
<head>
<meta charset="UTF-8"/>
<script type="text/Javascript" src="https://code.jquery.com/jquery-1.6.4.min.js"></script>
<script type="text/Javascript">
$(function() {
  window.addEventListener("message", function(event) {
    if (event.origin != "https://Lulingniu") return;
    $("#console").append(event.origin).append("傳來的消息:").append(event.data);

    // 向主頁面發送消息
    event.source.postMessage("Hello, there is :" + this.location, event.origin);
  }, false);
});
</script>
</head>
<body>
<p>這是 iframe 中的內容。</p>
<div id="console"></div>
</body>
</Html>

重點整理

  • 監聽 window 的 message 事件即可接收訊息。
  • 透過 message 事件的 origin 屬性可取得訊息的來源。本例中,主頁面的來源是 https://Lulingniu,子頁面的來源是 https://www.blue-butterfly.Net。特別注意:來源(origin)與網站的 URL 不是同一個概念,origin 只包含「通訊協定+網域+連接埠」。為了不接收其他來源惡意送出的訊息,務必對 origin 做檢查。
  • 透過 message 事件的 data 屬性可取得訊息內容,可以是任何 JavaScript 物件(搭配 JSON 使用)。
  • 使用 postMessage() 發送訊息,並以第二個參數明確指定目標來源。
  • 透過 message 事件的 source 屬性,可取得訊息來源視窗的代理物件,進而對來源視窗回傳訊息——子頁面正是用這個方式回覆主頁面的。

實務上,只要涉及 iframe 嵌入、跨網域視窗互動,或第三方腳本與主站溝通,這套機制幾乎都是首選。切記兩條安全底線:發送時給出精確的 targetOrigin,接收時驗證 event.origin。

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