萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript iframe 與父視窗雙向操作:元素存取、值傳遞、函式呼叫完整指南

核心存取模式

iframe → 父視窗

// 取值
var val = window.parent.document.getElementById("elementId").value;

// 取值 (jQuery)
var val = $(window.parent.document).find("#elementId").val();

// 設值
window.parent.document.getElementById("elementId").value = "新值";

// 設值 (jQuery)
$(window.parent.document).find("#elementId").val("新值");

// 呼叫父視窗函式
window.parent.parentFunction();
// 或
parent.parentFunction();

父視窗 → iframe

// 取值 (原生)
var iframe = document.getElementById("iframeId");
var val = iframe.contentWindow.document.getElementById("elementId").value;

// 取值 (jQuery)
var val = $("#iframeId").contents().find("#elementId").val();

// 設值
iframe.contentWindow.document.getElementById("elementId").value = "新值";

// 設值 (jQuery)
$("#iframeId").contents().find("#elementId").val("新值");

// 呼叫 iframe 內函式
document.getElementById("iframeId").contentWindow.childFunction();
// 或
window.frames["iframeName"].childFunction();

跨瀏覽器相容封裝函式

// 取得 iframe 的 document 物件 (相容 IE/FF/Chrome)
function getIframeDoc(iframeEl) {
    if (iframeEl.contentDocument) {
        return iframeEl.contentDocument; // W3C 標準 (FF, Chrome, IE9+)
    } else if (iframeEl.contentWindow) {
        return iframeEl.contentWindow.document; // IE8-
    } else if (iframeEl.document) {
        return iframeEl.document; // 極舊 IE
    }
    return null;
}

// 父視窗 → iframe 通用取值
function getIframeValue(iframeId, elementId) {
    var iframe = document.getElementById(iframeId);
    var doc = getIframeDoc(iframe);
    return doc ? doc.getElementById(elementId).value : null;
}

// 父視窗 → iframe 通用設值
function setIframeValue(iframeId, elementId, value) {
    var iframe = document.getElementById(iframeId);
    var doc = getIframeDoc(iframe);
    if (doc) doc.getElementById(elementId).value = value;
}

完整互動範例

父視窗 (a.html)

<!DOCTYPE html>
<html>
<head>
    <script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
    <script>
        function setChildValue() {
            // jQuery 方式
            $('#childFrame').contents().find("#bbb").val("父視窗設定的值");
        }
        
        function parentFunc() {
            alert("父視窗函式被子視窗呼叫!");
        }
    </script>
</head>
<body>
    <div id="maindiv">父視窗內容</div>
    <iframe id="childFrame" name="childFrame" src="b.html" width="600" height="400"></iframe>
    <br>
    <button onclick="setChildValue()">給子視窗輸入框賦值</button>
</body>
</html>

子視窗 (b.html)

<!DOCTYPE html>
<html>
<head>
    <script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
    <script>
        function callParent() {
            // 呼叫父視窗函式
            window.parent.parentFunc();
            
            // 設定父視窗元素
            $(window.parent.document).find("#maindiv").html("子視窗傳來的值");
        }
    </script>
</head>
<body>
    <form name="cform">
        <input type="text" name="b" id="bbb" />
        <button type="button" onclick="callParent()">呼叫父視窗函式並賦值</button>
    </form>
</body>
</html>

jQuery 選取器進階用法

// 父視窗選取 iframe 所有文字輸入框
var $inputs = $(window.frames["iframeSon"].document).find(":text");

// iframe 選取父視窗所有文字輸入框
var $inputs = $(window.parent.document).find(":text");

// iframe 選取父視窗所有 radio 並全選
$(window.parent.document).find("input[type='radio']").prop("checked", true);

同源策略限制與解決

條件結果
同源(協定+域名+埠號相同)✅ 可直接存取 DOM、呼叫函式
跨域❌ 瀏覽器阻擋存取 contentWindow.document,拋出 SecurityError
跨域但需通訊使用 window.postMessage()

postMessage 跨域通訊標準模式

// 父視窗
window.addEventListener("message", function(e) {
    if (e.origin !== "https://child.example.com") return; // 驗證來源
    if (e.data.action === "setValue") {
        document.getElementById(e.data.id).value = e.data.value;
    }
});

// 子視窗 (不同域名)
function notifyParent(id, value) {
    window.parent.postMessage({
        action: "setValue",
        id: id,
        value: value
    }, "https://parent.example.com"); // 指定目標源
}

常見坑點

  1. iframe 未載入完成就操作:需在 iframe.onload 後執行
  2. jQuery 版本不一致:父子視窗各載入不同版本導致 API 差異 → 共用 parent.$
  3. contentWindow vs contentDocument 混淆:前者是 Window 物件,後者是 Document 物件
  4. 巢狀 iframe:window.parent.parent 逐層向上,window.top 直接到頂層

現代架構建議

避免使用 iframe 傳遞資料。優先考慮:

  • 單頁應用 (SPA):Vue/React Router 管理視圖,共享狀態
  • Web Components:Shadow DOM 封裝,屬性/事件雙向綁定
  • SharedWorker / BroadcastChannel:同源多分頁/視窗狀態同步
  • postMessage:僅在必須嵌入第三方內容(支付、地圖、編輯器)時使用
copyright © 萬盛學電腦網 all rights reserved