iframe 在複合文件中經常出現,而父子視窗之間的存取一直是容易出錯的地方。以下把 DOM 與 jQuery 兩套寫法整理成對照表,並補上框架互相引用的規則。
// 父視窗操作 iframe
window.frames["iframeSon"].document
// iframe 操作父視窗
window.parent.document
// 在父視窗中選取 iframe 內所有文字輸入框
$(window.frames["iframeSon"].document).find(":text");
// 在 iframe 中選取父視窗所有文字輸入框
$(window.parent.document).find(":text");
iframe 本身的標籤:
<iframe src="test.html" id="iframe1" width="700" height="300"
frameborder="0" scrolling="auto"></iframe>
父視窗中勾選 iframe 內所有單選鈕:
$(window.frames["iframe1"].document).find("input[@type='radio']").attr("checked", "true");
iframe 中勾選父視窗所有單選鈕:
$(window.parent.document).find("input[@type='radio']").attr("checked", "true");
取得 iframe 內某元素的內容,還有幾種等效寫法:
// 取得 body 內容
$(document.getElementById('iframeId').contentWindow.document.body).html();
// 依 iframe 的 name 取得其中某元素
$("#testId", document.frames("iframename").document).html();
// 作用同上
$(window.frames["iframeName"].document).find("#testId").html();
// 用 contents() 進入 iframe 文件
$("#mainiframe").contents().find("#someID").html();
頁面中所有框架以集合形式作為 window 的屬性提供,例如 window.frames 代表該頁所有框架的集合。要引用某個子框架,可用 window.frames["frameName"]、window.frames.frameName 或 window.frames[index],其中 window 可換成 self 或省略。每個框架各自是一個獨立視窗,因此引用框架等同引用 window 物件。
父框架到子框架:
window.frames["frameName"];
window.frames["frameName"].frames["frameName2"]; // 二級子框架
子框架到父框架:每個 window 都有 parent 屬性;若已是頂層,parent 指向自己。
window.parent;
兄弟框架之間:同屬一個父框架的兩個框架,可透過父框架互相引用。
<frameset rows="50%,50%">
<frame src="1.html" name="frame1" />
<frame src="2.html" name="frame2" />
</frameset>
// 在 frame1 中引用 frame2
self.parent.frames["frame2"];
不同層次與頂層框架:
self.parent.frames["childName"].frames["targetFrameName"];
// 判斷自己是否為頂層框架
if (self == top) {
// do something
}
同源性限制。若 iframe 載入的是跨網域頁面,基於同源政策,父頁無法讀取其文件內容,上述所有 find 都會失敗並丟出安全性錯誤。這種情況只能改用 postMessage 溝通。
選擇器語法已過時。範例中的 input[@type='radio'] 是 jQuery 1.2 時代的寫法,1.3 之後拿掉 @ 前綴,應寫成 input[type='radio']。
attr 與 prop。jQuery 1.6 起,checked、disabled 這類狀態屬性應改用 prop(),attr 只負責讀取 HTML 原始屬性,混用會導致狀態不同步。