彈出視窗與模態對話框是早期 Web 互動的主要手段。這兩個 API 參數繁多,本文把常用寫法與完整參數表整理清楚,並說明它們今日的處境。
支援環境:JavaScript 1.0+ / JScript 1.0+ / Nav 2+ / IE 3+ / Opera 3+
基本語法:
window.open(pageURL, name, parameters)
其中 pageURL 是子視窗的路徑,name 是子視窗的識別名稱(可作為 target 使用),parameters 是視窗參數,各參數以逗號分隔。
基本範例:
<script>
window.open('page.html', 'newwindow',
'height=100,width=400,top=0,left=0,' +
'toolbar=no,menubar=no,scrollbars=no,' +
'resizable=no,location=no,status=no')
</script>
執行後,page.html 會在一個名為 newwindow 的新視窗中開啟:寬 400、高 100,距螢幕頂端與左側皆為 0,無工具列、無選單列、無捲軸、不可調整大小、無網址列、無狀態列。
其中 yes/no 也可寫成 1/0;pixel value 為具體數值,單位是像素。
| 參數 | 取值範圍 | 說明 |
|---|---|---|
| alwaysLowered | yes/no | 指定視窗隱藏在所有視窗之後 |
| alwaysRaised | yes/no | 指定視窗懸浮在所有視窗之上 |
| depended | yes/no | 是否與父視窗同時關閉 |
| directories | yes/no | Nav 2 和 3 的目錄欄是否可見 |
| height | pixel value | 視窗高度 |
| hotkeys | yes/no | 在沒有選單列的視窗中設定安全退出熱鍵 |
| innerHeight | pixel value | 視窗中文檔的像素高度 |
| innerWidth | pixel value | 視窗中文檔的像素寬度 |
| location | yes/no | 網址列是否可見 |
| menubar | yes/no | 選單列是否可見 |
| outerHeight | pixel value | 設定視窗(含邊框裝飾)的像素高度 |
| outerWidth | pixel value | 設定視窗(含邊框裝飾)的像素寬度 |
| resizable | yes/no | 視窗大小是否可調整 |
| screenX | pixel value | 視窗距螢幕左邊界的像素距離 |
| screenY | pixel value | 視窗距螢幕上邊界的像素距離 |
| scrollbars | yes/no | 視窗是否可有捲軸 |
| titlebar | yes/no | 視窗標題列是否可見 |
| toolbar | yes/no | 視窗工具列是否可見 |
| Width | pixel value | 視窗的像素寬度 |
| z-look | yes/no | 視窗被啟動後是否浮在其他視窗之上 |
基本介紹:showModalDialog() 需 IE 4 以上支援,showModelessDialog() 需 IE 5 以上支援。前者用來建立一個顯示 HTML 內容的模態對話框,後者則是非模態對話框。
使用方法:
vReturnValue = window.showModalDialog(sURL [, vArguments] [, sFeatures]) vReturnValue = window.showModelessDialog(sURL [, vArguments] [, sFeatures])
參數說明:
sURL — 必選,字串型別。指定對話框要顯示的文件 URL。
vArguments — 可選,變體型別。用來向對話框傳遞參數,型別不限,包含陣列。對話框透過 window.dialogArguments 取得傳入的參數。
sFeatures — 可選,字串型別。描述對話框的外觀等資訊,可使用以下一項或數項,以分號隔開:
以下幾個屬性用在 HTA 中,一般網頁通常不使用:
父視窗 → 對話框,透過 vArguments 傳入。型別不限,字串型別最大 4096 字元,也可以傳物件。
parent.htm:
<script>
var obj = new Object();
obj.name = "51js";
window.showModalDialog("modal.htm", obj,
"dialogWidth=200px;dialogHeight=100px");
</script>
modal.htm:
<script>
var obj = window.dialogArguments;
alert("您傳遞的參數為:" + obj.name);
</script>
對話框 → 父視窗,透過 window.returnValue 回傳,同樣可以是物件。
parent.htm:
<script>
var str = window.showModalDialog("modal.htm", "",
"dialogWidth=200px;dialogHeight=100px");
alert(str);
</script>
modal.htm:
<script> window.returnValue = "https://www.cnblogs.com"; </script>
把多個欄位組裝成查詢字串傳入,是常見用法:
var psAddStr = "ProcessID=" + ProcessID +
"&AddFlag=" + isAddFlag +
"&BZBH=" + vsBZBH +
"&BZMC=" + vsBZMC +
"&BZFH=" + vsBZFH +
"&JD=" + vsJD;
var Result = window.showModalDialog(
"addSave.asp?" + psAddStr, '',
"dialogHeight:250px;dialogWidth:250px;status:no;"
);
必須說明的是,showModalDialog() 與 showModelessDialog() 皆為 IE 專屬,且已被微軟標記為 deprecated,從未進入任何 Web 標準,其他瀏覽器完全不支援。因此上面這套寫法今天只能用於維護純 IE 環境的內部系統。
而 window.open() 雖然是標準 API 且仍可使用,但現代瀏覽器基於安全與體驗考量做了大量限制:多數情況下 toolbar、location、status、resizable 等參數會被忽略;非由使用者手勢直接觸發的 window.open() 會被阻擋型快顯視窗封鎖機制攔下;而 alwaysRaised、z-look 這類舊式 DOM 特性早已不復存在。
現代的對應做法有三種:用 <dialog> 元素搭配 showModal(),這是標準的模態對話框方案,自帶焦點鎖定與 Esc 關閉,並提供 ::backdrop 樣式化遮罩;用 CSS 覆蓋層搭配焦點管理自行實作,適合需要高度客製外觀的場景;用元件庫如 Radix、Headless UI 等,它們已處理好焦點陷阱、鍵盤操作與 ARIA 屬性等無障礙細節。
<dialog id="myDialog">
<form method="dialog">
<p>確定要儲存嗎?</p>
<button value="ok">確定</button>
<button value="cancel">取消</button>
</form>
</dialog>
<script>
var dialog = document.getElementById('myDialog');
dialog.showModal();
dialog.addEventListener('close', function () {
console.log(dialog.returnValue); // "ok" 或 "cancel"
});
</script>
自己實作彈出層時,最容易被忽略的是焦點管理:開啟時要把焦點移入對話框、關閉時要還給原本的觸發元素,並用 document.body.style.overflow = 'hidden' 鎖住背景捲動。這些細節直接決定無障礙體驗是否合格。