在頁面被切分成 frame 或 iframe 的架構裡,「子頁面呼叫父頁面的函數」是非常日常的需求。本文把常見的幾種取用路徑整理清楚,並說明各個 window 相關屬性的定位差異。
一、最基本的形式:子頁面呼叫父頁面函數
子頁面中:
onclick="window.parent.frames.aaa()"
父頁面中:
function aaa() {
alert('bbbbb');
}
釐清幾個容易混淆的屬性
parent:frame 架構中,某個頁面要操作同框架下的其他頁面或父框架頁面時使用。
window.opener:參照的是由 window.open 開啟的那個頁面的父頁面。
window.frames:可以參照 iframe 裡的頁面,也可以參照 frameset 裡的頁面。
因此存取子框架內容可以這樣寫:
window.frames[0].document.getElementById('xx');
或者取用整個 body 內容:
window.frames[0].document.body.innerHTML; frm = window.parent.window.frames['uploadFrame']; frmDocument = frm.document; frm.sb(3); // sb 是 uploadFrame 頁面裡的一個函數
二、Firefox 相容性陷阱
如果在 Firefox 中遇到 parent.document.frames has no properties 這類錯誤,改用下面的寫法即可,它在 IE 與 Firefox 都能正常運作:
frm = window.parent.window.frames['uploadFrame'];
關鍵觀念在於:frames 集合並不是掛在 document 底下,而是掛在 window 物件下。理解這一點,很多跨瀏覽器的錯誤就能避免。
三、同域限制與跨子域名的處理
必須強調一個前提:以這種方式修改 frame 內的頁面有明確限制——必須處於同一個網域下,否則瀏覽器的同源政策會直接阻擋存取。
如果是同一主網域但子網域不同(例如 www.example.com 與 app.example.com),只要雙方涉及的 js、html 檔案都加上同一行宣告即可:
document.domain = 'example.com'; // 填入你的主網域
document.getElementById('iframeid').contentWindow
.document.getElementById('someelementid');
這裡的關鍵是兩邊設定的值必須完全一致,且只能是主網域,不能設成比目前所屬網域更「窄」的值。
四、彈窗頁面呼叫父頁面函數
假設要呼叫父頁面的 test2():
window.opener.test2();
五、框架子頁面呼叫上一層的方法
例如上一頁面的框架名為 menuBar,要呼叫其中的 onhook():
window.top.frames["menuBar"].onhook();
六、彈窗頁面呼叫父頁面框架中的子頁面函數
window.opener.top.frames['menuBar'].onhook();
實務提醒
這幾段寫法背後其實是同一套規則:window 物件構成一棵樹,parent 往上、frames 往下、opener 橫向連到開啟者、top 直指最上層。只要把這四個方向記清楚,任何跨頁面呼叫都能推導出來。
不過要提醒的是,除了同域限制之外,若對方頁面沒有事先把函數掛在全域(例如被包在 IIFE 或模組作用域內),一樣取不到。此外,以 document.domain 放寬同源限制等於同步放寬了安全邊界,在只需要單向溝通的場合,改用 postMessage 並搭配明確的 origin 檢查,是更安全的選擇。