DIV CSS 佈局教程網

jQuery 跨 iframe 操作父頁面的正確寫法與常見地雷
編輯:JQuery特效代碼     

頁面裡嵌了 iframe,而 iframe 內的腳本需要改動外層頁面的內容——這在後台系統、編輯器預覽、支付頁 etc. 都很常見。用 jQuery 一行就能做到,但真正會卡住人的是瀏覽器與同源政策。

父頁面


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="https://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>無標題文檔</title>
</head>
<body>
<div style="height:300px; background-color:#CC9900"></div>
<div>
<iframe src="test_iframe.html"></iframe>
</div>
</body>
</html>

iframe 頁面


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="https://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>無標題文檔</title>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.4.2/jquery.min.js"></script>
<script>
$("body", parent.document).append('hahaha');
</script>
</head>
<body>
iframe test
</body>
</html>

關鍵在於第二個參數

jQuery 的簽名是:


jQuery(html, [ownerDocument])

參數說明:

  • html(String):用於動態建立 DOM 元素的 HTML 標記字串。
  • ownerDocument(可選,Document):建立 DOM 元素所在的文件。

也就是說,$("body", parent.document) 的意思是「在父頁面的文件裡尋找 body」,而不是在自己的文件裡找。少了 parent.document 這個上下文,你就只是在 iframe 內部操作,當然看不到任何效果。這是 jQuery 文件裡容易被掃過去的參數,但正是跨 frame 操作的鑰匙。

相對地,若 iframe 要存取其父頁面的 window 物件(例如呼叫父頁的函式),寫 parent.someFunction();要往上多層則是 window.top。

補記:Chrome 上的失敗經驗

實測時發現 Chrome 怎麼樣都做不出效果。查了資料後歸納出兩個原因:

一、跨來源(cross-origin)限制。同源政策不允許你讀寫不同 origin 的 iframe 文件。這裡的 origin 由「通訊協定 + 主機 + 連接埠」三者共同決定,任一不同就算跨域,此時存取 parent.document 會直接丟出安全錯誤。解法只有一個:讓父子頁面同 origin,或使用 postMessage 做跨域溝通。

二、file:// 協定下的行為不一致。直接用檔案路徑開啟頁面時,各瀏覽器對 file origin 的判定不同,Chrome 尤其嚴格。把兩頁放在同一個站台下測試即可:


https://localhost:8087/test.html

改用 http 提供之後,Chrome 的表現就正常了。

實務建議

如果你正在設計新的系統,我會建議別讓 iframe 內外互相直接操作 DOM。這種耦合會讓除錯變得非常痛苦:錯誤訊息只說「access denied」,你無從判斷是哪一層出問題。改用 postMessage 反而更清晰——子頁 parent.postMessage({type:'height', value: 500}, 'https://你的網域'),父頁監聽 message 事件並在 callback 裡更新版面。

使用 postMessage 時務必做兩件事:發送端明確指定 targetOrigin(不要用 "*"),接收端則要驗證 event.origin 是否在白名單內,並只處理你預期中的 message 格式。少了這些檢查,等於把頁面交給任何來源都能操控。

書讀百遍,其義自見——但讀文件時,可選參數千萬別跳過。

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