本文是上一篇《js 實現 iframe 框架取值的方法》的延伸應用,解決一個更實際的問題:怎麼知道 iframe 裡的頁面已經加載完畢?
iframe 有一個相當獨特的用途:配合 P3P 協議實現跨域寫入 cookie(除此之外似乎很難找到更有效的替代方案)。但在這類場景中,我們往往不清楚 iframe 內的頁面是否已經執行完成。
顯然,只有等裡面的腳本跑完、數據就位之後,外部才能安全地讀取。於是需要一個輪詢檢測機制。
我們準備兩個「內頁」,分別在 3 秒和 6 秒後把輸入框的值改成 ok,以此模擬不確定的加載耗時。
iframe1.html:
<html>
<head>
<title>框架內頁</title>
</head>
<body>
<div>
<input id="txt" name="txt" type="text" value="3秒鐘後這裡會變成ok" />
</div>
<script type="text/javascript">
setTimeout("SetValue()", 3000);
function SetValue(){
document.getElementById("txt").value = "ok";
}
</script>
</body>
</html>
iframe2.html:
<html>
<head>
<title>框架內頁</title>
</head>
<body>
<div>
<input id="txt" name="txt" type="text" value="6秒鐘後這裡會變成ok" />
</div>
<script type="text/javascript">
setTimeout("SetValue()", 6000);
function SetValue(){
document.getElementById("txt").value = "ok";
}
</script>
</body>
</html>
<html>
<head>
<title>檢測本頁中的所有iframe是否加載完成</title>
<script type="text/javascript">
// 取得 iframe 中某個 html 控件的值
function getIframeControlValue(iframeId, controlId){
var ofrm = document.getElementById(iframeId).document;
if (ofrm == undefined) {
ofrm = document.getElementById(iframeId).contentWindow.document;
var ff = ofrm.getElementById(controlId).value;
return ff;
} else {
var ie = document.frames[iframeId].document.getElementById(controlId).value;
return ie;
}
}
// 檢測所有的 iframe 是否"加載"完成
function fnLoadOk(){
var b = true;
for (var i = 1; i <= 2; i++) {
if (getIframeControlValue("frame" + i, "txt") == "ok") {
b = b && true;
} else {
b = b && false;
}
}
return b;
}
// 設置回答顯示區的值
function setValue(str){
if (str != null && str.length > 0) {
document.getElementById("result").innerHTML =
"<span style='color:red'>" + new Date().toLocaleString() + " " + str + "</span>";
} else {
document.getElementById("result").innerHTML =
"<span style='color:green'>" + new Date().toLocaleString() + " 正在加載" + "</span>";
}
}
var _check = setInterval("t()", 500); // 每隔 0.5 秒檢查一次
function t(){
if (fnLoadOk()) {
clearInterval(_check); // 加載完成後,清除定時器
setValue("加載完成!");
} else {
setValue();
}
}
</script>
</head>
<body>
<h3>檢測本頁中的iframe是否加載完成</h3>
<iframe name="frame1" id="frame1" src="iframe1.html" frameborder="1" height="60" width="180"></iframe>
<iframe name="frame2" id="frame2" src="iframe2.html" frameborder="1" height="60" width="180"></iframe>
<div id="result" style="margin:10px;">
准備就緒
</div>
</body>
</html>
判定依據是「業務信號」而非 load 事件。這個示例的做法比較特別:它不是去監聽 iframe 的 load 事件,而是把「輸入框的值是否等於 ok」當作完成標誌。這在跨域或內頁腳本耗時不確定的場景下反而更可靠——load 事件觸發只代表文檔解析完畢,不代表裡面的異步任務都跑完了。
完成後必須清除定時器。clearInterval(_check) 這一步不能省,否則檢測會一直跑下去,白白消耗資源。
檢測入口的時機很重要。示例中的檢測是在定時器驅動下進行的,因此沒有時序問題。但如果你打算頁面一打開就立即檢測,一定要放在 body 的 onload 事件中,否則會出異常——因為此時 index.html 自身尚未加載完成,急著去取框架內容只會拿到 undefined 或 null。
需要指出的是,getIframeControlValue 中那套 document / contentWindow.document 的分支判斷,是為了兼容老舊 IE 與 Firefox 的差異。在現代瀏覽器中,統一用 iframe.contentDocument 即可。
此外,如今的標準做法已經不是輪詢,而是監聽 iframe 的 load 事件:
element.addEventListener('load', handler) 或 jQuery 的 $(element).on('load', handler)。
不過要記住一個前提:同源限制依然存在。如果 iframe 加載的是跨域頁面,父頁面讀取它的 DOM 會直接拋出安全錯誤,這時只能依賴 postMessage 進行跨窗口通信,或者退回到本文這種「約定一個可觀測的業務信號」的思路——但那個信號也必須是同源的。