DIV CSS 佈局教程網

window.open 參數完整解析與實務注意事項
編輯:JavaScript基礎知識     

window.open() 是開啟新視窗的標準方法,參數看似簡單,細節卻不少。以下把四個參數與各項 specs 設定完整整理。

開篇提醒:在 IE9 環境下使用 window.open 時,name 參數的值不能包含「-」符號,否則會出現腳本錯誤。IE9 及後續版本經測試沒有這個問題。

語法

window.open(URL, name, specs, replace)

參數一:URL

可選。指定要開啟的頁面網址。若未提供 URL,會開啟一個新的空白視窗。

參數二:name

可選。用來指定 target 屬性或視窗名稱,支援以下值:

  • _blank — URL 載入到一個新的視窗。這是預設值。
  • _parent — URL 載入到父框架。
  • _self — URL 取代目前的頁面。
  • _top — URL 取代任何可載入的框架集。
  • name — 自訂的視窗名稱。若已有同名視窗存在,會直接復用它而非新開。

最後這一點實務上很容易踩到:同一個 name 連續呼叫兩次,第二次不會開新視窗,而是把內容載入既有視窗。若每次都想要新視窗,請一律使用 _blank。

參數三:specs

可選。以逗號分隔的項目清單,用來控制新視窗的外觀與行為。

  • channelmode=yes|no|1|0 — 是否以影院模式顯示視窗,預設否。僅限 IE。
  • directories=yes|no|1|0 — 是否顯示目錄按鈕,預設是。僅限 IE。
  • fullscreen=yes|no|1|0 — 是否以全螢幕模式顯示,預設否。全螢幕模式下還必須同時開啟影院模式。僅限 IE。
  • height=pixels — 視窗高度,最小值為 100。
  • left=pixels — 視窗左側位置。僅限 IE。
  • location=yes|no|1|0 — 是否顯示網址欄,預設是。
  • menubar=yes|no|1|0 — 是否顯示選單列,預設是。
  • resizable=yes|no|1|0 — 是否可調整視窗大小,預設是。
  • scrollbars=yes|no|1|0 — 是否顯示捲軸,預設是。
  • status=yes|no|1|0 — 是否顯示狀態列,預設是。
  • titlebar=yes|no|1|0 — 是否顯示標題列,預設是。除非呼叫的是 HTML 應用程式或可信任的對話框,否則會被忽略。
  • toolbar=yes|no|1|0 — 是否顯示瀏覽器工具列,預設是。
  • top=pixels — 視窗頂部位置。僅限 IE。
  • width=pixels — 視窗寬度,最小值為 100。

一個實用範例——開啟一個 800×600、置中、可捲動、不可縮放的視窗:

var left = (screen.width - 800) / 2;
var top = (screen.height - 600) / 2;

window.open(
  'detail.html',
  '_blank',
  'width=800,height=600,left=' + left + ',top=' + top +
  ',resizable=no,scrollbars=yes,status=no'
);

參數四:replace

可選。決定載入到視窗的 URL 是在瀏覽歷史中建立新條目,還是取代目前條目。

  • true — URL 取代瀏覽歷史中的目前條目。
  • false — URL 在瀏覽歷史中建立新條目。

這個參數在避免使用者按「上一頁」時又回到開啟頁的場景下很有用。

幾個實務上的重要提醒

1. 現代瀏覽器已大幅限制視窗外觀控制。 上述 specs 中多數項目(如 toolbar、location、status、resizable)在現代 Chrome、Firefox、Safari 中會被忽略,基於安全考量瀏覽器不再允許網頁隱藏這些 UI。實際上只有 width、height、left、top、scrollbars 等少數項目還有效果。

2. 會被攔截的情況。 window.open 若不在使用者互動(點擊、按鍵)的同步呼叫堆疊中執行,例如放在 setTimeout 或 Ajax 回呼裡,多數瀏覽器會把它視為彈出視窗並阻擋。若必須在非同步流程中開窗,常見做法是先在點擊時同步開一個空視窗取得參照,資料回來後再設定其 location。

3. 优先考虑新分頁而非新視窗。 除了確有必要(例如需要獨立視窗尺寸的列印或對帳單頁面),一般導向都應該用 window.open(url, '_blank') 讓瀏覽器自己決定開分頁或視窗,或直接改用 <a target="_blank" rel="noopener">。順帶一提,加上 rel="noopener" 可以避免新頁面透過 window.opener 反向操作你的頁面,這是一個實際的安全考量。

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