萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery 操作 iframe 跨文檔選取元素的多種方法總結

iframe 嵌入頁面時,父子文檔間的元素選取與操作是常見需求。本文系統整理**原生 DOM**、**jQuery 選擇器**、**.contents()** 等多種獲取 iframe 內部元素的方法,並針對同域/跨域場景給出最佳實踐。

核心引用鏈

方向原生 DOMjQuery 封裝
父 → 子window.frames["name"].document
iframeEl.contentWindow.document
iframeEl.contentDocument (IE8+)
$(window.frames["name"].document).find(...)
$("iframe").contents().find(...)
子 → 父window.parent.document
window.top.document
$(window.parent.document).find(...)

jQuery 常用選取示例

1. 父頁面選取子 iframe 所有文本框

// 方式 A:window.frames
$(window.frames["iframeSon"].document).find(":text");

// 方式 B:.contents() (推薦,鏈式調用)
$("#iframeSon").contents().find(":text");

// 方式 C:原生 document 後包裹
$(document.getElementById('iframeSon').contentWindow.document.body).html();

2. 子頁面選取父頁面所有單選鈕

$(window.parent.document).find("input[type='radio']").prop("checked", true);

3. 父頁面操作子 iframe 具體 ID 元素

// 多種等價寫法
$(window.frames["iframe1"].document).find("#testId").html();
$("#iframe1").contents().find("#testId").html();
$("iframe[name='iframe1']").contents().find("#testId").val();

完整頁面演示代碼

<html xmlns="https://www.w3.org/1999/xhtml">
<head>
<script src="js/jquery-1.2.6.js"></script>
<script>
$(function(){
    // 示例:父頁面修改子 iframe 中 id="d1" 的顏色
    $("#iframe1").contents().find("#d1").css('color', 'red');
    
    // 示例:父頁面修改子 iframe 中 name="t1" 的輸入框背景
    $(window.frames["iframe1"].document).find("input[name='t1']").css({background: "#369"});
    
    // 示例:動態修改 iframe src
    // $("#iframe1").attr("src", "newpage.html"); // 此處 .src() 非標準,應用 .attr()
});
</script>
</head>
<body>
<input id="t1" />
<iframe id="iframe1" src="child.htm"></iframe>
<iframe height="100" src="child.htm" width="300"></iframe>
</body>
</html>

跨域限制與解決方案

  • 同域策略:父子頁面**協議、域名、端口**完全一致,可直接互訪 DOM。
  • 跨子域:雙方設置 document.domain = 'base.com'(僅限主域相同,且**已被標準廢棄**,現代瀏覽器漸漸移除支援)。
  • 完全不同域:必須使用 window.postMessage 進行消息傳遞。
    // 父頁面發送
    iframe.contentWindow.postMessage({action: 'getData', id: 1}, 'https://child.com');
    
    // 子頁面監聽
    window.addEventListener('message', e => {
        if (e.origin !== 'https://parent.com') return;
        if (e.data.action === 'getData') {
            e.source.postMessage({result: 'data'}, e.origin);
        }
    });

常見坑點避雷

  1. iframe.onload 後才能安全訪問 .contents(),否則文檔未就緒報錯。
  2. jQuery 1.6+ .prop() 替代 .attr() 設置 checked/disabled 等布爾屬性。
  3. 選擇器 input[@type='radio'] 為 jQuery 1.2 舊語法,**現代版本請用 input[type='radio']** (去掉 @)。
  4. 巢狀 iframe (iframe 套 iframe) 需層層 .contentWindow 穿透,極易出錯,建議扁平化架構。

現代替代建議

  • 微前端方案 (qiankun, Module Federation) 替代 iframe 嵌入應用。
  • 組件化開發 (Vue/React/Angular) 替代頁面級 iframe 嵌入。
  • 第三方嵌入 (支付、地圖、編輯器) 仍需 iframe,請封裝 postMessage 通信 SDK。

熟練掌握 iframe DOM 穿透技巧是維護老系統必備技能,新架構設計應盡量避免 iframe 帶來的樣式隔離、通信複雜、SEO 不利等問題。

copyright © 萬盛學電腦網 all rights reserved