所有瀏覽器都支援 window 物件,它代表瀏覽器視窗本身。理解它的意義在於:JavaScript 中所有的全域物件、函式與變數,其實都自動成為 window 的成員——全域變數是它的屬性,全域函式是它的方法。這也是為什麼全域命名空間一旦髒亂,整個頁面都會互相干擾。
window.open(URL, 視窗名稱, 視窗樣式)
open 會開啟一個新視窗並載入指定網址,回傳該視窗的參考。第二個參數可指定視窗名稱,第三個參數則用逗號分隔的字串描述樣式,常見選項包括:
toolbar:是否顯示工具列location:是否顯示網址列directories:是否顯示連結列status:是否顯示狀態列menubar:是否顯示選單列scrollbar:內容超出時是否顯示捲軸resizable:是否允許調整大小width / height:視窗寬高(像素,已建議改用 innerWidth/innerHeight)outerWidth / outerHeight:含工具列的外部寬高left / top:距螢幕左側與頂端的距離dependent:設為子視窗,隨父視窗關閉而關閉alwaysRaised / alwaysLowered:永遠置於最上層或最下層titleBar、hotkeys、screenX、screenY 等上述樣式的開關值多為 1/yes 表示開啟、0/no 表示關閉。要留意現代瀏覽器基於安全考量,已大幅限制這些項目,多數會被忽略。
window.close(); // 關閉視窗
window.alert("提示文字"); // 警告框
window.confirm("確定要刪除嗎?"); // 確認框,回傳 true / false
window.prompt("請輸入姓名", "預設值"); // 輸入框,回傳字串或 null
這三者都是同步且會阻斷執行的,正式產品中通常會改用自製的 Modal 元件。
var t = window.setTimeout(fn, 1000); // 一次性延遲
window.clearTimeout(t); // 取消
var i = window.setInterval(fn, 1000); // 週期性執行
window.clearInterval(i); // 取消
window.moveBy(dx, dy); // 相對位移
window.moveTo(x, y); // 絕對定位
window.resizeBy(dx, dy); // 相對縮放,負值為縮小
window.resizeTo(w, h); // 絕對尺寸
window.scrollBy(dx, dy); // 相對捲動
window.scrollTo(x, y); // 捲到指定座標
window.scroll(x, y); // 同 scrollTo
window.back(); // 等同按「上一頁」
window.forward(); // 等同按「下一頁」
window.home(); // 等同按「首頁」
window.stop(); // 等同按「停止」
window.print(); // 開啟列印對話框
實務上更推薦使用 history.back()、history.forward() 這類標準 API,上述幾個方法在部分瀏覽器(如 IE5.5)並不支援。
window.blur(); // 移出焦點
window.focus(); // 取得焦點
window.captureEvent(Event.CLICK | Event.KEYDOWN);
window.releaseEvent(Event.CLICK);
window.handleEvent(event);
window.routeEvent(event);
window.enableExternalCapture(event);
window.disableExternalCapture();
可捕捉的 Event 類型包含 ABORT、BLUR、CHANGE、CLICK、DBLCLICK、DRAGDROP、ERROR、FOCUS、KEYDOWN、KEYPRESS、KEYUP、LOAD、MOUSEDOWN、MOUSEMOVE、MOUSEOUT、MOUSEOVER、MOUSEUP、MOVE、RESET、RESIZE、SELECT、SUBMIT、UNLOAD 等。多個事件之間以「|」串接。
要特別說明:這一族事件捕捉 API 屬於 Netscape 時期的遗留設計,現代標準已改由 addEventListener 的第三個參數(capture 布林值)取代,不建議再使用。
window.status = "載入中...";
window.defaultstatus = "就緒";
window.statusbar.visible; // 狀態列是否可見
window.location = "https://example.com"; // 讀取或跳轉
window.name = "myWindow"; // 視窗名稱
window.closed; // 是否已關閉
window.innerWidth; // 文件區寬度(不含工具列)
window.innerHeight; // 文件區高度
window.outerWidth; // 含工具列的外部寬度
window.outerHeight; // 含工具列的外部高度
window.pageXOffset; // 文件左上角的當前水平位置
window.pageYOffset; // 文件左上角的當前垂直位置
window.self; // 當前視窗自身的參照,多視窗時避免混淆
window.parent; // 父視窗
window.top; // 最頂層視窗
window.opener; // 開啟本視窗的視窗
window.frames["框架名稱"];
window.frames[0];
window.frames.length;
window.length; // 子視窗數量
window.document; // 文件物件,DOM 的入口
window.history; // 歷史紀錄物件
以下幾組屬性結構相同,都是透過子屬性 visible 來判斷是否顯示,回傳布林值:locationbar、menubar、personalbar、scrollbars、toolbar、statusbar。
window.toolbar.visible;
window.menubar.visible;
window.personalbar.visible;
window.scrollbars.visible;
window.locationbar.visible;
本文中介紹的許多方法與屬性帶有明顯的時代痕跡,find、back、forward、home、stop、以及各工具列的 visible 屬性,在 IE5.5 中多半不支援,而在現代瀏覽器中有些已被移除或僅能唯讀。撰寫新專案時,請以標準 BOM API 為準:window.screen、window.history、window.location、window.navigator、requestAnimationFrame 與 addEventListener。把這份清單當成「讀懂舊程式碼的字典」而非「新專案的選單」,才是正確的使用姿勢。