DIV CSS 佈局教程網

js 彈出視窗實戰:window.open 與 showModalDialog 全參數解析
編輯:關於JavaScript     

彈出視窗與模態對話框是早期 Web 互動的主要手段。這兩個 API 參數繁多,本文把常用寫法與完整參數表整理清楚,並說明它們今日的處境。

一、window.open()

支援環境: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 為具體數值,單位是像素。

參數取值範圍說明
alwaysLoweredyes/no指定視窗隱藏在所有視窗之後
alwaysRaisedyes/no指定視窗懸浮在所有視窗之上
dependedyes/no是否與父視窗同時關閉
directoriesyes/noNav 2 和 3 的目錄欄是否可見
heightpixel value視窗高度
hotkeysyes/no在沒有選單列的視窗中設定安全退出熱鍵
innerHeightpixel value視窗中文檔的像素高度
innerWidthpixel value視窗中文檔的像素寬度
locationyes/no網址列是否可見
menubaryes/no選單列是否可見
outerHeightpixel value設定視窗(含邊框裝飾)的像素高度
outerWidthpixel value設定視窗(含邊框裝飾)的像素寬度
resizableyes/no視窗大小是否可調整
screenXpixel value視窗距螢幕左邊界的像素距離
screenYpixel value視窗距螢幕上邊界的像素距離
scrollbarsyes/no視窗是否可有捲軸
titlebaryes/no視窗標題列是否可見
toolbaryes/no視窗工具列是否可見
Widthpixel value視窗的像素寬度
z-lookyes/no視窗被啟動後是否浮在其他視窗之上

三、window.showModalDialog 使用手冊

基本介紹: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 — 可選,字串型別。描述對話框的外觀等資訊,可使用以下一項或數項,以分號隔開:

  1. dialogHeight:對話框高度,不小於 100px。IE 4 中 dialogHeight 與 dialogWidth 預設單位是 em,IE 5 中是 px;為方便起見,定義 modal 對話框時建議用 px。
  2. dialogWidth:對話框寬度。
  3. dialogLeft:離螢幕左側的距離。
  4. dialogTop:離螢幕上側的距離。
  5. center:{yes | no | 1 | 0},視窗是否居中,預設 yes,但仍可指定高度與寬度。
  6. help:{yes | no | 1 | 0},是否顯示說明按鈕,預設 yes。
  7. resizable:{yes | no | 1 | 0}(IE 5+),是否可改變大小,預設 no。
  8. status:{yes | no | 1 | 0}(IE 5+),是否顯示狀態列。預設在 Modeless 為 yes、Modal 為 no。
  9. scroll:{yes | no | 1 | 0 | on | off},是否顯示捲軸,預設 yes。

以下幾個屬性用在 HTA 中,一般網頁通常不使用:

  1. dialogHide:{yes | no | 1 | 0 | on | off},列印或列印預覽時對話框是否隱藏,預設 no。
  2. edge:{sunken | raised},對話框邊框樣式,預設 raised。
  3. unadorned:{yes | no | 1 | 0 | on | off},預設 no。

四、參數傳遞的兩種方向

父視窗 → 對話框,透過 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' 鎖住背景捲動。這些細節直接決定無障礙體驗是否合格。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved