iframe 裡的頁面要讀取父頁面的元素、呼叫父頁面的函式,是後台系統常見的整合需求。以下用一個 ASP.NET 的雙頁範例完整示範。
一、在 iframe 中查找父頁面的元素:
$('#id', window.parent.document)
二、在 iframe 中呼叫父頁面定義的方法與變數:
parent.method parent.value
父頁面定義了一個全域變數 hello 與一個函式 getHelloWorld(),並且在頁面上放了一個 id 為 default 的 div 作為被讀取的目標,以及承載子頁面的 iframe。
<head runat="server">
<script language="javascript" type="text/javascript" src="jquery-1.5.1.min.js"></script>
<script language="javascript" type="text/javascript">
var hello = 'hello';
function getHelloWorld() {
alert('hello world');
}
</script>
</head>
<body>
<form id="form1" runat="server">
<div>
<div id="default" style="width:200px; height:400px; float:left;">default.aspx</div>
<iframe id="iframeid" src="IFrame.aspx"
style="width:400px; height:400px; float:left;"></iframe>
</div>
</form>
</body>
<script language="javascript" type="text/javascript">
$(function() {
// 在 iframe 中查找父頁面元素
alert($('#default', window.parent.document).html());
// 在 iframe 中呼叫父頁面定義的方法
parent.getHelloWorld();
// 在 iframe 中讀取父頁面定義的變數
alert(parent.hello);
});
</script>
<body>
<form id="form1" runat="server">
<div id="iframe">IFrame.aspx</div>
</form>
</body>
第一,context 參數是關鍵。 $('#default', window.parent.document) 的第二個參數告訴 jQuery「到哪份 document 裡找」。少了它,jQuery 會在子頁面自己的 DOM 中搜尋,當然找不到父頁面的元素。這是初學者最常漏掉的一步。
第二,parent 是 window 物件。 parent.getHelloWorld() 之所以能呼叫,是因為 parent 指向父視窗的 window 物件,而函式宣告在全域就是掛在 window 上的屬性。同理,全域變數 hello 也能透過 parent.hello 直接讀到。若要跨更多層,用 top 指向最頂層;parent.parent 則逐層往上。
第三,反向操作也不難。 父頁面要取得 iframe 內的元素,寫成 $("#iframeid").contents().find("#iframe") 即可,同樣是換一份 document 的概念。
範例把程式碼放在 $(document).ready 裡是對的,但要注意時序:子頁面的 ready 觸發時,父頁面的 DOM 通常已就緒;反之若父頁面想在 ready 時操作子頁面,子頁面的 DOM 可能還沒建好,需要改綁 iframe 的 load 事件。
另外,範例中的 alert 只是示範,實務上更常見的是子頁面把表單資料回傳給父頁面,或呼叫父頁面的函式刷新某個區塊。這類溝通若牽涉到跨網域,同源政策會全數擋下,必須改用 postMessage。最後提醒,jQuery 1.5.1 已相当老舊,建議升級到 3.x 並注意 .live() 等 API 的移除。