萬盛學電腦網

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

JavaScript window.open 彈出視窗與父子視窗資料傳遞完整指南

window.open 完整語法

var newWin = window.open(sUrl, sName, sFeatures, bReplace);
參數說明
sUrl要載入的頁面 URL,省略則開啟 about:blank
sName視窗名稱,可作為 <a target="name"> 或 <form target="name"> 目標。特殊值:_blank 新視窗、_self 當前、_parent 父框架、_top 最頂層
sFeatures功能字串,逗號分隔。常用:
width=600,height=400,left=100,top=100,resizable=yes,scrollbars=yes,status=yes,location=yes,menubar=yes,toolbar=yes
最小寬高 100px。未指定的功能預設為 no。
bReplaceBoolean。true:新頁面取代歷史紀錄當前項;false (預設):新增歷史紀錄。

回傳值

回傳新視窗的 Window 物件參考 (newWin),父視窗可透過它存取子視窗 DOM、變數、函數。若被攔截器攔截,回傳 null。

完整範例:父視窗開啟子視窗,子視窗回寫資料給父視窗

父視窗 (parent.html)

<!DOCTYPE html>
<html><head><meta charset="utf-8"><title>父視窗</title></head>
<body>
    <textarea id="txtData" rows="5" cols="40" placeholder="等待子視窗回傳資料..."></textarea>
    <br>
    <button onclick="openChild()">開啟子視窗</button>

    <script>
        function openChild() {
            // 置中開啟
            var w = 400, h = 300;
            var left = (screen.width - w) / 2;
            var top = (screen.height - h) / 2;
            var features = `width=${w},height=${h},left=${left},top=${top},resizable=yes,scrollbars=yes`;
            
            window.open('child.html', 'childWin', features);
        }
    </script>
</body></html>

子視窗 (child.html)

<!DOCTYPE html>
<html><head><meta charset="utf-8"><title>子視窗</title></head>
<body>
    <p>子視窗內容</p>
    <button onclick="sendToParent()">傳送資料給父視窗並關閉</button>

    <script>
        function sendToParent() {
            // 檢查 opener 是否存在且未關閉
            if (window.opener && !window.opener.closed) {
                var parentTextarea = window.opener.document.getElementById('txtData');
                var currentVal = parentTextarea.value;
                var newVal = currentVal + (currentVal ? '\n' : '') + '子視窗回傳時間: ' + new Date().toLocaleTimeString();
                parentTextarea.value = newVal;
            } else {
                alert('父視窗已關閉或不存在,無法傳遞資料。');
            }
            window.close();
        }
    </script>
</body></html>

進階:父視窗主動從子視窗取值 (輪詢/事件)

// 父視窗
var childWin = window.open('child.html', 'childWin', 'width=400,height=300');

// 方式一:輪詢檢查子視窗狀態 (不推薦,效能差)
var checkTimer = setInterval(function() {
    if (childWin.closed) {
        clearInterval(checkTimer);
        console.log('子視窗已關閉');
        // 此時無法直接取值,需子視窗關閉前主動寫入父視窗
    }
}, 500);

// 方式二:子視窗關閉前觸發父視窗回調 (推薦)
// 父視窗定義回調
window.childCallback = function(data) {
    console.log('收到子視窗資料:', data);
    document.getElementById('txtData').value = JSON.stringify(data);
};

// 子視窗關閉前呼叫
// window.opener.childCallback({ id: 1, name: 'test' });
// window.close();

跨網域限制 (同源策略)

  • 父子視窗**同源** (協定、域名、埠口相同):可自由互存取 DOM、變數、函數。
  • 父子視窗**跨源**:window.opener 存在,但存取其 document、location 等屬性會拋出 SecurityError。
  • 跨源通訊解決方案:postMessage API。
    // 子視窗發送
    window.opener.postMessage({ type: 'DATA', payload: { id: 1 } }, 'https://parent-domain.com');
    
    // 父視窗接收
    window.addEventListener('message', function(e) {
        if (e.origin !== 'https://child-domain.com') return; // 驗證來源
        if (e.data.type === 'DATA') console.log('收到:', e.data.payload);
    });

常見問題與解決

問題原因/解決
彈出視窗被瀏覽器攔截非使用者主動點擊事件中呼叫 window.open。解決:綁定在 onclick 等使用者互動事件中。
子視窗 window.opener 為 null父視窗已關閉、跨域且未設定 rel="noopener"、或瀏覽器安全策略。解決:開啟時不加 noopener,或用 postMessage。
父視窗無法取得子視窗回傳值子視窗關閉前未主動寫入父視窗。解決:子視窗 onbeforeunload 或按鈕點擊時呼叫 opener.callback(data)。
mobile 瀏覽器彈出視窗體驗差行動裝置建議改用頁面內 Modal (Dialog) 替代 window.open。

總結

window.open 是傳統彈出視窗 API,核心難點在於**父子視窗通訊**與**攔截器/跨域限制**。現代開發建議:

  1. 優先使用頁面內 Modal (Dialog) 替代彈出視窗。
  2. 必須用彈出視窗時,採用 postMessage 進行安全跨域通訊。
  3. 子視窗關閉前主動通知父視窗 (回調函數或 postMessage),而非父視窗輪詢。
  4. 行動裝置體驗優先考量響應式 Modal。
copyright © 萬盛學電腦網 all rights reserved