iframe 的跨框架操作一直是個容易混淆的主題。這篇把 jQuery 的常用寫法與原生 JavaScript 的框架引用規則整理在一起,作為查閱用的參考。
<iframe id="leftiframe" ...></iframe>
<iframe id="mainiframe" ...></iframe>
// 在 leftiframe 中改變 mainiframe 的 src
$("#mainframe", parent.document.body).attr("src", "https://www.example.com");
// iframe 內含 <div id="someID">you want to get this content</div>
$("#mainiframe").contents().find("someID").html(); // 取 HTML
$("#mainiframe").contents().find("someID").text(); // 取純文字
$(window.frames["iframe1"].document).find("input[@type='radio']").attr("checked","true");
$(window.frames["iframe1"].document).find("#id"); // 選 id 也是用 find
$("#mainframe", parent.document.body).contents().find("someID").html();
$("#mainframe", parent.document.body).contents().find("someID").val();
一個頁面中的所有框架會以集合形式作為 window 物件的屬性提供。window.frames 就代表該頁面內所有框架的集合——這點和表單、連結、圖片集合類似,不同的是那些是 document 的屬性。因此要引用子框架,有這幾種等價寫法:
window.frames["frameName"] window.frames.frameName window.frames[index] // window 可用 self 代替或省略 self.frames["frameName"] frames[0] frameName
每個框架都對應一個 HTML 頁面,所以框架本身也是一個獨立的瀏覽器視窗,具備視窗的所有性質。所謂「引用框架」其實就是引用它的 window 物件,有了它就能用 window.document 寫入資料、用 window.location 換頁。
window.frames["frameName"]; // 一級子框架 window.frames["frameName"].frames["frameName2"]; // 二級子框架,以此類推
每個 window 物件都有 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"];
和 parent 類似,window 物件還有 top 屬性指向最頂層框架,常用來判斷自己是否為頂層:
if (self == top) {
// 本框架就是頂層框架
}
以上所有寫法都有一個共同前提:父頁面與 iframe 必須同來源(同 protocol、同網域、同連接埠)。一旦跨網域,瀏覽器會直接拋出安全性錯誤,contents() 與 frames[] 都取不到東西。這種情況只能改用 postMessage 進行跨視窗溝通。另外範例中的 @ 屬性選擇器語法請省略,frameset 也已在 HTML5 中廢除,新專案請改用 iframe 搭配 flex 排版。