動態建立 iframe 之後,怎麼知道它已經載入完成?這看似基本,但瀏覽器之間的實作差異讓它變成一個經典的相容性問題。
最直覺的做法是判斷瀏覽器,標準瀏覽器用 onload,IE 則用 onreadystatechange 並檢查 readyState:
var iframe = document.createElement("iframe");
iframe.src = "https://www.jb51.net";
if (!/*@cc_on!@*/0) { //if not IE
iframe.onload = function(){
alert("Local iframe is now loaded.");
};
} else {
iframe.onreadystatechange = function(){
if (iframe.readyState == "complete"){
alert("Local iframe is now loaded.");
}
};
}
document.body.appendChild(iframe);
這裡的 /*@cc_on!@*/0 是 IE 條件式編譯註解的小技巧:在 IE 中它會被編譯成 !0(也就是 false),在其他瀏覽器中就是單純的註解。這種寫法很聰明,但 readability 極差,今天不建議再用。
Nicholas C. Zakas 在〈Iframes, onload, and document.domain〉一文中討論了這個議題,評論區的 Christopher 提供了一個更漂亮的解法:
var iframe = document.createElement("iframe");
iframe.src = "https://sc.jb51.net";
if (iframe.attachEvent){
iframe.attachEvent("onload", function(){
alert("Local iframe is now loaded.");
});
} else {
iframe.onload = function(){
alert("Local iframe is now loaded.");
};
}
document.body.appendChild(iframe);
第一,IE 其實支援 onload。它並非不支援,而是這個事件是「隱形」的——無法用 iframe.onload = ... 指派,必須透過 attachEvent 註冊才會生效。因此用特性偵測判斷 attachEvent 是否存在,就能同時覆蓋兩種情況。
第二,readystatechange 有潛在問題。相對於 load 事件,readyState 的變化在部分情境下會觸發多次或不按預期觸發,導致同一段程式碼執行好幾次;而 onload 的語意明確,就是「載入結束」這一件事。
現代瀏覽器已經一致支援 onload,上面兩段程式碼都不再需要。直接寫即可:
var iframe = document.createElement("iframe");
iframe.onload = function(){
console.log("iframe 已載入完成");
};
iframe.src = "https://example.com";
document.body.appendChild(iframe);
另外有兩點值得注意:一是跨來源 iframe 的內容你無法讀取(同源政策),onload 觸發時只能確定文件載入完畢,不代表裡面的資源都就緒;二是若 iframe 的 src 在 DOM 插入前就已設定,某些舊瀏覽器可能不觸發 load,因此實務上建議「先綁定 onload,再設定 src,最後插入 DOM」。