DIV CSS 佈局教程網

jQuery 與原生 JS 跨 iframe 存取父視窗與子視窗元素的方法整理
編輯:JQuery特效代碼     

頁面裡嵌了 iframe,父頁要讀子頁的表單值,或子頁要呼叫父頁的函式,都屬於跨文件存取。同源時很簡單,跨源時則被瀏覽器嚴格禁止。以下把常見的五種情境整理清楚。

1. jQuery:在 iframe 子頁面取得父頁面元素

$("#objid", parent.document)

jQuery 的第二個參數是「上下文」,等同先在 parent.document 中搜尋 #objid。

2. jQuery:在父頁面取得 iframe 子頁面的元素

$("#objid", document.frames('iframename').document)

這種寫法依賴 iframe 的 name 屬性。更通用、也更推薦的方式是用 contentWindow 或 contentDocument:

$("#objid", $("iframe")[0].contentDocument);
// 或
$("#objid", $("iframe").contents());

.contents() 是 jQuery 專為此設計的方法,能同時處理 HTML 文件與其他節點類型,跨 iframe 時比 document.frames() 可靠得多。

3. 原生 JS:子頁面取得父頁面元素

window.parent.document.getElementById("元素id");

4. 原生 JS:父頁面取得子頁面元素

window.frames["iframe_ID"].document.getElementById("元素id");

同樣建議改用較新的 API:

var frame = document.querySelector('iframe').contentWindow;
var doc   = frame.document;          // 或 contentDocument
var el    = doc.getElementById("元素id");

5. 子頁面呼叫父頁面的函式

window.parent.func();

若 iframe 又巢狀了 iframe,parent 只會指向上一層。要取得最外層請用 window.top。實務上建議先確認自己是否為頂層,避免在獨立開啟該頁時拋出錯誤:

if (window.parent && window.parent !== window) {
    window.parent.func();
}

反向:父頁面呼叫子頁面函式

document.querySelector('iframe').contentWindow.myFunc();

最重要的一條:同源政策

以上所有寫法都有一個前提——父子頁面必須同源,也就是通訊協定、網域、連接埠三者完全相同。只要有一項不同(例如 https 頁面嵌 http 的 iframe,或 a.com 嵌 b.com),瀏覽器會直接拋出 SecurityError,任何存取嘗試都無效。這不是可以繞過的限制,而是瀏覽器安全模型的核心。

跨源情境下的正解是 postMessage:

// 子頁面 → 父頁面
window.parent.postMessage({ type: 'height', value: 320 }, 'https://parent.example.com');

// 父頁面接收
window.addEventListener('message', function (e) {
    if (e.origin !== 'https://child.example.com') { return; }   // 務必驗證來源
    if (e.data && e.data.type === 'height') {
        // 處理
    }
});

接收端一定要檢查 e.origin。少了這一步,任何網站都能對你的頁面發送訊息,等於把後門敞開。

附帶提醒

  • 以 id 搜尋 iframe 時,window.frames["iframe_ID"] 未必可靠。那個索引依賴的是 iframe 的 name 屬性而非 id,兩者不一致時會取不到。用 querySelector 選元素再取 contentWindow 最穩。
  • 跨文件存取完記得清理。若 iframe 已被移除或導向新頁面,先前取得的 contentWindow 參照會失效,存取時可能拋錯,需要包在 try/catch 或先檢查存在性。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved