萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> JSP 程式設計

iframe 嵌套 EasyUI 頁面:父頁面正確訪問子頁面組件的方法與坑點

常見錯誤現象

父頁面通過 `` 嵌入 EasyUI 頁面。嘗試在父頁面訪問子頁面 DataGrid:

// ❌ 錯誤寫法:jQuery 選取器返回的是 iframe DOM 元素,無 contentWindow 屬性
$('#ss_frame').contentWindow.$('#dgMANUF').datagrid('getSelected');
// 報錯:無法獲取屬性 "nodeName" 的值: 對象為 null 或未定義

正確訪問方式 (兩種)

// ✅ 方式一:原生 DOM 獲取 iframe 元素,再取 contentWindow
document.getElementById('ss_frame').contentWindow.$('#dgMANUF').datagrid('getSelected');

// ✅ 方式二:jQuery 獲取 iframe DOM 陣列第一個元素
$.find('iframe')[0].contentWindow.$('#dgMANUF').datagrid('getSelected');

核心原則:必須先獲取原生 `iframe` DOM 元素的 `contentWindow` (子頁面 `window` 物件),再在其上下文中執行 jQuery/EasyUI API。

進階坑點:iframe 動態載入的時序問題

若父頁面動態修改 `iframe.src` 載入新頁面,腳本立即執行訪問會失敗,因子頁面尚未載入完成。

解決方案:載入完成信號機制

// 父頁面:修改 src 後,等待子頁面就緒信號
function loadIframe(url) {
    var iframe = document.getElementById('ss_frame');
    iframe.src = url;
    // 方案 A:輪詢檢查子頁面標記變數
    var checkReady = setInterval(function() {
        try {
            if (iframe.contentWindow && iframe.contentWindow.pageReady === true) {
                clearInterval(checkReady);
                // 此處安全調用子頁面 API
                iframe.contentWindow.$('#dgMANUF').datagrid('reload');
            }
        } catch (e) { /* 跨域或未載入完成,忽略 */ }
    }, 100);

    // 方案 B:子頁面載入完成後主動通知父頁面 (推薦,需控制子頁面代碼)
    // 子頁面 (easyui-page.jsp) 底部加入:
    // <script> parent.onIframeReady && parent.onIframeReady(); </script>
    // 父頁面定義:
    // window.onIframeReady = function() { ...安全調用... };
}

文中提到的「輸出 loading 文字」方案分析

document.getElementById('ss_frame').contentWindow.document.write('loading...');

此法雖能觸發文檔重寫,但屬於 Hack 手段,副作用大:會清空子頁面原有 DOM、觸發重新解析、可能導致已綁定事件失效。**強烈不推薦生產環境使用。**

最佳實踐總結

  1. **獲取子頁面 window**:`document.getElementById('iframeId').contentWindow`
  2. **同源策略**:父子頁面必須同域 (協議/域名/埠相同),否則跨域安全限制無法訪問。
  3. **生命週期同步**:採用「子頁面主動通知父頁面 `onload` 事件」模式,而非父頁面輪詢或 Hack。
  4. **EasyUI 組件代理**:在子頁面封裝對外暴露的 API 物件 (如 `window.gridApi = { reload:..., getSelected:... }`),父頁面調用 `iframe.contentWindow.gridApi.getSelected()`,降低耦合。
copyright © 萬盛學電腦網 all rights reserved