只要用 iframe 做過多頁籤或左右分欄的管理介面,就一定會遇到「我在這個框裡,要怎麼動到那個框裡的東西」的問題。JavaScript 提供的通道其實很單純,整理如下。
取得父頁面的 document 物件
var parentDoc = window.parent.document;
拿到之後就能搜尋父頁面的元素、修改它的內容,例如把選到的資料寫進父頁面的某個欄位。
呼叫父頁面全域函式
window.parent.someMethod();
這是最乾淨的做法。與其直接伸手改父頁面的 DOM,不如在父頁面定義一個語意明確的函式(例如 setSelectedUser(id)),子頁面只負責呼叫。這樣父子之間的耦合會小很多,日後改動介面也不至于全盤崩掉。
若 iframe 是巢狀的,window.top 可直達最外層;window.parent 只上一層。
// mainFrame 為父頁面中 iframe 標籤的 id
var child = document.getElementById("mainFrame").contentWindow;
var childDoc = child.document; // 子頁面的 document
新版瀏覽器也可以寫成 document.getElementById("mainFrame").contentDocument,兩者等效。
取得 childDoc 後,操作方式與一般 DOM 無異;要呼叫子頁面自己定義的函式,則用 child.someMethod()。
同源限制。父子頁面必須同 protocol、同 host、同 port。跨來源時,讀寫對方 document 一律拋錯,只能改用 postMessage 通訊。
載入時序。父頁面的 window.onload 早於 iframe 內容就緒,太早伸手會撲空。請把邏輯掛在 iframe 的 onload,或在子頁面主動「報到」通知父頁面。
錯誤難以察覺。跨頁面的例外不會出現在呼叫端的錯誤堆疊裡,除錯時記得開啟瀏覽器開發工具的「所有例外」,並確認兩個頁面的來源是否一致。
iframe 傳值的所有技巧,本質上都是在補 iframe 這個元件「隔離」特性的漏洞。若專案還在評估階段,用前端框架的元件化拆分、或以 Web Component 的 Shadow DOM 達到類似隔離效果,通常比維護一堆 iframe 來得省心。既有系統要維護也無妨,把父子溝通收斂到一層 message 契約上,會比四處直接操作 DOM 好照顧得多。