- 跨文档消息传送(cross-document messaging),简称XDM,指的是在来自不同域的页面间传递消息。对于XDM而言,“另一个地方”指的是包含在当前页面中的<iframe>元素,或者由当前页面弹出的窗口
XDM的核心是postMessage()方法,该方法接受两个参数:一条信息和一个表示消息接收方来自哪个域的字符串。第二个参数对保障安全通信非常重要,可以防止浏览器把小心发送到不安全的地方。
//对于页面中的iframe,所有支持XDM的浏览器也支持iframe的contentWindow属性
var iframeWindow = document.getElementById("myFrame").contentWindow;
iframeWindow.postMessage("A secret", "http://www.wrox.com"); //发送方代码
最后一行代码尝试向内嵌框架中发送一条消息,并制定框架中的文档必须来源“http://www.wrox.com”。如果来源匹配,消息会传送到内嵌框架
接收到XDM消息后,会触发window对象的message事件。这个事件是以异步触发的。触发message事件后,传递给onmessage处理程序的事件对象包含以下三方面重要信息。
data:作为postMessage()第一个参数传入的字符串数据(可用JSON.stringify生成JSON字符串来传递)
origin:发送消息的文档所在的域,例如"http://www.wrox.com"
source: 发送消息的文档的window对象的代理。这个代理主要用于在发送上一条消息的窗口(iframe内嵌)中调用postMessage()方法。如果发送消息的窗口来自同一个域,那这个对象就是window
window.addEventListener("message",function(){ if(event.origin == "http://www.wrox.com"){ processMessage(event.data); //处理接收的数据
event.source.postMessage("Received!", "http://p2p.wrox.com"); //可选:向来源窗口发送回执 }
},
false)