iframe 在後台管理、報表、舊系統整合裡很常見。用 jQuery 跨框架取元素,本質上是「先拿到對方的 document,再拿它當上下文去 find」。把這層觀念釐清,之後各種變形寫法都能自己推出來。
// 父視窗 → 子 iframe 的 document
window.frames["iframeSon"].document
// 子 iframe → 父視窗的 document
window.parent.document
把上面拿到的 document 包進 $(),就能直接鏈上 jQuery 的方法:
// 父視窗中,選取 iframe 內所有文字輸入框
$(window.frames["iframeSon"].document).find(":text");
// iframe 中,選取父視窗內所有文字輸入框
$(window.parent.document).find(":text");
框架宣告對應如下:
<iframe src="test.html" id="iframeSon" width="700" height="300"
frameborder="0" scrolling="auto"></iframe>
1. 父視窗把 iframe 內的單選鈕全部勾選
$(window.frames["iframe1"].document)
.find("input[type='radio']")
.attr("checked", "true");
2. iframe 反過來操作父視窗的單選鈕
$(window.parent.document)
.find("input[type='radio']")
.attr("checked", "true");
這組寫法在 IE7 上實測可通。新專案請改用 .prop("checked", true),attr 處理布林屬性在 jQuery 1.6 之後行為已變。
// 直接取 iframe body 的 HTML
$(document.getElementById('iframeId').contentWindow.document.body).html()
// 依 name 定位 iframe,再取其中 id 為 testId 的元素
$("#testId", document.frames("iframename").document).html();
// 同上,寫法更直覺
$(window.frames["iframeName"].document).find("#testId").html()
// 用 contents() 進入 iframe 內部
$("#mainiframe").contents().find("#someID").html()
$("#mainiframe").contents().find("#someID").text()
contents() 是最省事的寫法,但要注意:iframe 尚未載入完成時會拿到空文件。
頁面裡有 leftiframe 與 mainiframe 兩個框架時:
// leftiframe 中,改變 mainiframe 的 src
$("#mainframe", parent.document.body).attr("src", "https://www.example.com");
// leftiframe 中,操作 mainiframe 內某元素的內容
$("#mainframe", parent.document.body).contents().find("#someID").html()
$("#mainframe", parent.document.body).contents().find("#someID").val()
頁面中的所有框架會以集合形式掛在 window 上,這點和 document.forms、document.images 的性質一樣。以下寫法彼此等價:
window.frames["frameName"]
window.frames.frameName
window.frames[0]
self.frames["frameName"]
frames[0]
frameName
父 → 子:
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"];
取得頂層:用 top 屬性,也常用來判斷自己是否已在最上層:
if (self == top) {
// 目前就是頂層框架
}
最後提醒一個實務上的坑:以上所有跨框架讀寫都建立在同源前提上。不同來源(含跨子域未設定 document.domain)時,瀏覽器會直接拋出「拒絕存取」,那已經不是 jQuery 能解決的範圍了。