Window 物件代表瀏覽器中開啟的視窗,同時也是瀏覽器環境下的全域物件(頂層物件)。不論你宣告的變數還是內建的 setTimeout,最終都掛在它身上。本文把 Window 的屬性、方法與事件整理成一份可查閱的清單。
若頁面中包含 frame 或 iframe,瀏覽器會為主文件建立一個 window 物件,並為每個框架額外建立一個。值得一提的是,至今並沒有針對 window 的公開標準,但所有主流瀏覽器都實作並支援它。
| 屬性 | 說明 |
|---|---|
| closed | 回傳視窗是否已被關閉 |
| defaultStatus | 設定或回傳狀態列上的預設文字 |
| document | 對 Document 物件的唯讀參照 |
| history | 對 History 物件的唯讀參照 |
| innerHeight / innerWidth | 文件顯示區(視埠)的高度與寬度 |
| outerHeight / outerWidth | 整個瀏覽器視窗外部的高度與寬度 |
| length | 視窗中框架的數量 |
| location | 視窗或框架的 Location 物件 |
| name | 設定或回傳視窗名稱 |
| navigator | 對 Navigator 物件的唯讀參照 |
| opener | 回傳開啟這個視窗的視窗參照 |
| pageXOffset / pageYOffset | 頁面相對視窗左上角的橫向與縱向位移 |
| parent | 回傳父視窗 |
| screen | 對 Screen 物件的唯讀參照 |
| self | 對目前視窗本身的參照 |
| status | 設定狀態列文字 |
| top | 回傳最頂層的父視窗 |
| window | 等同 self,指向視窗自身 |
| screenLeft / screenTop screenX / screenY | 唯讀整數,視窗左上角在螢幕上的座標。IE、Safari、Opera 支援前者,Firefox 與 Safari 支援後者 |
| 方法 | 說明 |
|---|---|
| alert() | 顯示帶有訊息與確認鈕的警示框 |
| blur() | 把鍵盤焦點從頂層視窗移開 |
| clearInterval() / clearTimeout() | 取消由 setInterval / setTimeout 建立的計時器 |
| close() | 關閉瀏覽器視窗 |
| confirm() | 顯示帶有確認與取消鈕的對話框 |
| focus() | 把鍵盤焦點交給某個視窗 |
| moveBy() / moveTo() | 相對或絕對移動視窗位置 |
| open() | 開啟新視窗或搜尋已命名視窗 |
| print() | 列印目前視窗內容 |
| prompt() | 顯示可讓使用者輸入的對話框 |
| resizeBy() / resizeTo() | 相對或絕對調整視窗尺寸 |
| scrollBy() / scrollTo() | 相對或絕對捲動內容 |
| setInterval() | 以固定週期(毫秒)重複呼叫函式 |
| setTimeout() | 在指定毫秒後呼叫函式一次 |
window.name 用來設定視窗名稱,一個特別的性質是:瀏覽器重新整理後這個值不會被清除。這個特性正是無 iframe 跨域方案(window.name 跨域)的基礎。
window.innerHeight / innerWidth 回傳 CSS 佈局所佔用的視窗尺寸,數值包含捲軸。若要取得不含捲軸的可用寬度,需要自己減掉 document.documentElement.clientWidth 的差值。
window.pageXOffset / pageYOffset 回傳頁面的橫向與縱向捲動距離,是做「回到頂端」「浮動側欄」這類效果時判斷位置的依據。
screen 物件 描述的是顯示裝置本身,而非瀏覽器視窗:
screen.width; // 螢幕寬度(像素)
screen.height; // 螢幕高度(像素)
screen.availWidth;
screen.colorDepth;
在瀏覽器中,用 var 宣告的全域變數其實就是 window 的屬性:
var a = 1;
window.a; // 1
這也解釋了為什麼在函式內漏寫 var 會污染全域物件——那個變數同樣會被掛到 window 上。
onerror:一種老式的全域錯誤捕捉方式,能在腳本執行出錯時攔截訊息。
window.onerror = function(message, source, lineno) {
console.log("錯誤:" + message + ",位置:" + source + ":" + lineno);
};
三個互動式對話框是 Window 最基礎的與使用者溝通手段:
alert("Hello World");
// 只有一個「確定」鈕,通常用來通知訊息
var age = prompt("您的年齡?", 25);
// 帶輸入框,有「確定」與「取消」兩顆鈕,回傳字串或 null
var ok = confirm("你最近好嗎?");
// 回傳布林值:按確定為 true,按取消為 false
另外還有 load、resize、scroll、beforeunload 等常用事件,其中 beforeunload 常被拿來做「內容尚未儲存」的提醒。
Window 是瀏覽器環境的一切起點:它既是全域作用域,也是視窗操作的入口。理解 window 與 document、location、history、screen 這些子物件的分工,是寫好前端程式碼的基礎功。使用時仍需注意跨瀏器差異,特別是螢幕座標與狀態列這類老舊屬性。