頁面中嵌入 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>
以下是一個真實會踩坑的寫法(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()attachEvent,其他瀏覽器用 onload,兩者要分支處理(現代專案可直接用 iframe.onload)alert() 逐步確認,或直接用瀏覽器開發者工具監看 DOM 與網路時序,比盲猜有效得多掌握「先等對方就緒,再呼叫對方」這個原則,iframe 的跨視窗互動就不再棘手。