使用者填寫收貨地址時,既可以新建,也可以挑選先前存過的。由於使用者本身就是商戶,地址數量可觀,用一個下拉框全部列出來完全不實際;再加上需求方希望能按姓名篩選,於是勢必得開一個小視窗來做選擇與搜尋。剩下的問題就是:小視窗裡選好的資料,怎麼傳回父頁?
模態視窗的特性正好符合這個情境:開啟之後無法操作父視窗,必須等子視窗關閉,父頁才能繼續互動。這避免了使用者在選擇過程中誤觸背景,資料流也單純——父頁等待回傳值即可。
整個流程是:頁面上放一個地址選擇入口,點擊觸發 btn_click(),開啟模態視窗。
function btn_click() {
var returnValue = window.showModalDialog('chooseAddr.aspx', window,
'dialogWidth=500px;dialogHeight=600px;status=no');
if (returnValue !== "" && returnValue !== undefined) {
// 處理子視窗回傳的資料
}
}
第二個參數傳入 window,子視窗即可透過 window.dialogArguments 取得父視窗參考。
使用者完成篩選、勾選等一連串動作後按下確定,觸發 returnVal():
function returnVal() {
var retArr = new Array();
retArr[0] = "test0";
retArr[1] = "test1";
window.returnValue = retArr;
window.close(); // 關掉子視窗,父視窗才能繼續執行
}
回傳值不限於字串,陣列或物件都可以,父頁收到的就是同一份參考。
本例中,子視窗需要知道目前操作者的 id,才能撈出他先前填過的地址。做法很簡單,直接在開窗網址後面帶參數:
window.showModalDialog('chooseAddr.aspx?id=xxx', window, '...');
也就是用 GET 方式傳過去,子頁再用 location.search 或伺服器端語法解析即可。
模態視窗有幾個實務上的限制值得先知道:它會阻斷頁面執行緒的互動,不適合需要長時間停留的操作;部分瀏覽器對 window.close() 有限制,若非由 script 開啟的視窗可能關不掉;而 showModalDialog 本身已被標準淘汰。維護舊系統時這些寫法仍然有效,新專案則建議改用 <dialog> 搭配 showModal,或以區塊層級的彈窗元件實作,並把資料回傳改為 callback 或 Promise,結構會清楚得多。