DIV CSS 佈局教程網

JavaScript 操作 iframe 的六大常用技巧
編輯:JavaScript綜合知識     

iframe 的跨文件操作看起來瑣碎,但只要記住「取 window、取 document、往上找、往下找、等載入、列舉 frames」這六件事,日常就夠用了。前提都是:必須同源。

一、取得 iframe 的 window 物件

function getIframeWindow(element) {
  return element.contentWindow;
}

IE6 之後的所有版本、Firefox、Chrome 都支援 contentWindow,可以直接用。

網路上流傳另一種寫法 element.contentDocument.parentWindow,說法是「iframe 元素有 contentDocument 屬性指向其文件物件,再取 parentWindow 就能拿到 window」。實測在 Firefox 與 Chrome 上,contentDocument 並沒有 parentWindow 屬性,這條路走不通。有些相容層會寫成:

return element.contentWindow || element.contentDocument.parentWindow;

前半段永遠會先命中,後半段只是歷史遺留,可以省略。

二、取得 iframe 的 document 物件

var getIframeDocument = function (element) {
  return element.contentDocument || element.contentWindow.document;
};

標準瀏覽器(Chrome、Firefox、Safari)走 contentDocument;IE 沒有這個屬性,要透過 contentWindow.document 繞。用 || 串起兩種寫法是最簡潔的相容方案。

三、在 iframe 裡取得父頁面的 window

window.parent  // 父頁面
window.top     // 最頂層頁面

兩者通用於所有瀏覽器。差別在於巢狀深度:若 A 內嵌 B、B 內嵌 C,那麼在 C 裡 parent 是 B,top 是 A。

四、取得 iframe 在父頁面中的那個標籤元素

window.frameElement  // 型別為 HTMLElement

所有瀏覽器都支援。用它可以讀取 iframe 標籤本身的屬性(id、name、className),在需要在子頁裡調整自身容器樣式時很好用。

五、iframe 的 onload 事件:一個著名的 IE 陷阱

非 IE 瀏覽器都提供了標準的 onload:

var ifr = document.createElement('iframe');
ifr.src = 'https://www.jb51.net/index.php';
ifr.onload = function() { alert('loaded'); };
document.body.appendChild(ifr);

這段程式碼在 IE 中不會跳出任何提示。原因是 IE 在元素尚未插入 DOM 之前就指定 onload 時,事件不會被觸發。

IE 上的兩種解法

// 方法一:直接寫在 HTML 標籤上
<iframe onload="alert('loaded');" src="https://www.jb51.net/index.php"></iframe>

// 方法二:IE 專屬——把整個標籤字串餵給 createElement
var ifr = document.createElement(
  '<iframe onload="alert(\'loaded\');" src="https://www.jb51.net/index.php"></iframe>'
);
document.body.appendChild(ifr);

方法二看起來很離奇,但這確實是只有 IE 支援的用法:IE 的 createElement 接受 HTML 字串並據以建立元素,其他瀏覽器只認標籤名稱。

這兩種做法之所以有效,是因為 onload 是在元素已經存在於父頁面的情況下設定的,因此不涉及跨來源問題。

更統一的寫法:attachEvent

實際上 IE 是支援 onload 的,只是必須用 attachEvent 綁定,不能用 ifr.onload = ... 這種 DOM0 寫法:

var ifr = document.createElement('iframe');
ifr.src = 'https://b.jb51.net/b.php';
if (ifr.attachEvent) {
  ifr.attachEvent('onload', function(){ alert('loaded'); });
} else {
  ifr.onload = function() { alert('loaded'); };
}
document.body.appendChild(ifr);

用特性偵測(if (ifr.attachEvent))而非瀏覽器名稱判斷,是比較好的習慣——不依賴使用者代理字串,也不必列舉版本號。

六、window.frames

var ifr1 = document.getElementById('ifr1');
var ifr1win = window.frames[0];
ifr1win.frameElement === ifr1; // true
ifr1win === ifr1;              // false

這兩行說明了最容易被搞混的一件事:window.frames[n] 取到的是視窗物件,不是 HTML 元素。兩者透過 frameElement 互相指向對方,但彼此並不相等。要操作 iframe 內的內容用 frames,要操作 iframe 標籤本身用 getElementById。

跨來源的唯一正解

以上全部技巧都有同一個前提:同源政策。當 iframe 的來源與主頁不同(不同網域、不同連接埠、不同協定),任何存取 contentWindow 內部都會丟出安全性錯誤。

此時唯一正確的做法是 postMessage:

// 父頁面 → iframe
iframe.contentWindow.postMessage({ type: "getData" }, "https://example.com");

// iframe 內部接收
window.addEventListener("message", function (e) {
  if (e.origin !== "https://parent-page.com") return; // 務必驗證來源
  // 處理 e.data
});

接收端一定要檢查 e.origin。少了這一步,任何網站都能對你的 iframe 發送訊息,是常見的安全漏洞。

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