DIV CSS 佈局教程網

iframe 父子視窗互相呼叫 JavaScript 的完整做法與載入時機陷阱
編輯:關於JavaScript     

頁面中嵌入 iframe 後,父子視窗之間需要互相呼叫函式的情境非常常見。本文以一個實際案例貫穿說明:使用 EasyUI 的彈出視窗內嵌 iframe,既要讓子頁面通知父頁面關閉視窗,也要讓父頁面在子頁面載入完成後才追加資料,並說明為什麼必須處理載入時序問題。

一、案例背景

情境一:子視窗呼叫父視窗。父視窗打開一個「新增使用者資訊」的 iframe 子頁面,使用者點擊保存後,子頁面需要呼叫父視窗的 closeAddWindow() 方法,請父視窗關閉這個新增視窗。

情境二:父視窗呼叫子視窗,但受載入時序影響。父視窗打開一個「設定使用者權限」的 iframe 子視窗。子視窗載入時會把資料庫中所有權限都讀出來,接著父視窗要把這些權限資訊組成的 HTML 追加到 id 為 tb 的表格上。問題就在這裡:父視窗呼叫子視窗的載入方法後,找不到那個表格元素——因為子頁面的 DOM 尚未完全建立。解法是為 iframe 註冊 onload 事件,等載入完成後再執行追加動作。

二、基本語法備忘

1. 父視窗嵌入 iframe

<iframe id='myFrame' name="myFrame" src="FChild.html"
        width='100%' height='100%' frameborder='0'></iframe>

2. 父視窗呼叫子視窗的方法

myFrame.window.sonMethod();

3. 子視窗呼叫父視窗的方法

parent.fatherMethod();

4. 相容各瀏覽器的 iframe 載入完成事件

if (myFrame.attachEvent) {
    myFrame.attachEvent("onload", function () {
        alert("IE 專用的載入方法");
    });
} else {
    myFrame.onload = function () {
        alert("其他瀏覽器的載入方法");
    };
}

三、完整示範程式碼

Father.html(父視窗)

<!DOCTYPE html>
<html xmlns="https://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title></title>
</head>
<body>
<div>我是父視窗內容</div>
<div><input type="button" id="btnFather" value="呼叫子視窗方法" /></div>
<br /><br /><br />

<iframe id='myFrame' name="myFrame" src="FChild.html"
        width='100%' height='100%' frameborder='0'></iframe>

<script type="text/javascript">
document.getElementById("btnFather").onclick = function () {
    myFrame.window.sonMethod();
};

function fatherMethod() {
    alert("父視窗方法!");
}

if (myFrame.attachEvent) {
    myFrame.attachEvent("onload", function () {
        alert("IE 專用的載入方法");
    });
} else {
    myFrame.onload = function () {
        alert("其他瀏覽器的載入方法");
    };
}
</script>
</body>
</html>

FChild.html(子視窗)

<!DOCTYPE html>
<html xmlns="https://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<title></title>
</head>
<body>
<div style="border:1px solid red;">我是子窗體內容</div>
<div><input type="button" id="btnSon" value="呼叫父視窗方法" /></div>

<script type="text/javascript">
document.getElementById("btnSon").onclick = function () {
    parent.fatherMethod();
};

function sonMethod() {
    alert("子視窗方法!");
}
</script>
</body>
</html>

四、onload 到底在什麼時候必須用?

以下是一個真實會踩坑的寫法(EasyUI 框架):

<div id="divRoleUsers" title="設置用戶角色" class="easyui-window"
     closed="true" collapsible="false" minimizable="false" maximizable="false"
     style="width: 140px; height: 250px; padding: 5px;">
</div>

<div><input type="button" id="btn" value="設置用戶角色" /></div>

<script type="text/javascript">
$("#btn").click(function () {
    showSetUserRoleWindow();
});

function showSetUserRoleWindow() {
    var getSelections = $("#tt").datagrid("getSelections");

    if (getSelections.length > 1 || getSelections.length == 0) {
        $.messager.alert("錯誤提示", "請選中一行數據!", "error");
        return false;
    }

    var data = getSelections[0];   // 取得選中那一行的所有 json 資料

    // 關鍵步驟:先移除舊的 iframe
    // 若不移除,onload 的綁定只會生效一次,
    // 而我們需要每次載入 iframe 都呼叫一次子視窗的方法
    if ($("#divRoleUsers #myframe").length != 0) {
        $("#divRoleUsers #myframe").remove();
    }

    $('#divRoleUsers').append(
        "<iframe id='myframe' name='myframe' src='RoleUsers_Update.aspx' " +
        "width='100%' height='100%' frameborder='0'></iframe>"
    );

    if (myframe.attachEvent) {
        myframe.attachEvent("onload", function () {
            myframe.window.loadAllRole();
            myframe.window.loadUserRole(data.UserID);
        });
    } else {
        myframe.onload = function () {
            myframe.window.loadAllRole();          // 呼叫子視窗方法,載入所有角色 checkbox
            myframe.window.loadUserRole(data.UserID); // 傳入使用者 ID,勾選該使用者已有的角色
        };
    }

    $('#divRoleUsers').window('open');
}
</script>

這段程式碼記錄了作者嘗試過的幾條錯誤路線,值得逐一理解:

錯誤做法一:透過 src 拼接參數。原本寫成 src='RoleUsers_Update.aspx?UserID=" + data.UserID + "',企圖讓子視窗用 parent.document.getElementById("iframe").getAttribute("src") 取回 UserID。結果拿到的是 null——同樣是載入順序造成的問題。

錯誤做法二:忘記移除舊 iframe。若不移除既有節點就重新 append,onload 的綁定只會第一次生效,後續開窗時子視窗的方法不會被呼叫。因此 $("#divRoleUsers #myframe").remove() 這一步是必須的。

五、重點整理

  • 父子視窗互動本質上是跨文件的函式呼叫:父呼叫子用 iframeName.window.method(),子呼叫父用 parent.method()
  • 載入時機是絕大多數問題的根源。父視窗在 iframe 的 DOM 就緒前呼叫子視窗方法,必然取不到元素
  • 解法是註冊 onload;若要每次都觸發,必須先移除舊的 iframe 節點再重建
  • IE 需用 attachEvent,其他瀏覽器用 onload,兩者要分支處理(現代專案可直接用 iframe.onload)
  • 除錯時善用 alert() 逐步確認,或直接用瀏覽器開發者工具監看 DOM 與網路時序,比盲猜有效得多

掌握「先等對方就緒,再呼叫對方」這個原則,iframe 的跨視窗互動就不再棘手。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved