window 對象

代表瀏覽器中一個打開的窗口。

成員表

下面的表格列出了 window 對象引出的成員。請單擊左側(cè)的標簽來選擇你想要查看的成員類型。

屬性

屬性	描述
closed	獲取引用窗口是否已關(guān)閉。
defaultStatus	設(shè)置或獲取要在窗口底部的狀態(tài)欄上顯示的缺省信息。
dialogArguments	設(shè)置或獲取傳遞給模式對話框窗口的變量或變量數(shù)組。
dialogHeight	設(shè)置或獲取模式對話框的高度。
dialogLeft	設(shè)置或獲取模式對話框的左坐標。
dialogTop	設(shè)置或獲取模式對話框的頂坐標。
dialogWidth	設(shè)置或獲取模式對話框的寬度。
frameElement	獲取在父文檔中生成 window 的 frame 或 iframe 對象。
length	設(shè)置或獲取集合中對象的數(shù)目。
name	設(shè)置或獲取表明窗口名稱的值。
offscreenBuffering	設(shè)置或獲取對象在對用戶可見之前是否要先在屏幕外繪制。
opener	設(shè)置或獲取創(chuàng)建當前窗口的窗口的引用。
parent	獲取對象層次中的父窗口。
returnValue	設(shè)置或獲取從模式對話框返回的值。
screenLeft	獲取瀏覽器客戶區(qū)左上角相對于屏幕左上角的 x 坐標。
screenTop	獲取瀏覽器客戶區(qū)左上角相對于屏幕左上角的 y 坐標。
self	獲取對當前窗口或框架的引用。
status	設(shè)置或獲取位于窗口底部狀態(tài)欄的信息。
top	獲取最頂層的祖先窗口。

集合

集合	描述
frames	獲取給定文檔定義或與給定窗口關(guān)聯(lián)的文檔定義的所有 window 對象的集合。

事件

事件	描述
onactivate	當對象設(shè)置為活動元素時觸發(fā)。
onafterprint	對象所關(guān)聯(lián)的文檔打印或打印預(yù)覽后立即在對象上觸發(fā)。
onbeforedeactivate	在 activeElement 從當前對象變?yōu)楦肝臋n其它對象之前立即觸發(fā)。
onbeforeprint	對象的關(guān)聯(lián)文檔打印或打印預(yù)覽前在對象上觸發(fā)。
onbeforeunload	在頁面將要被卸載前觸發(fā)。
onblur	在對象失去輸入焦點時觸發(fā)。
oncontrolselect	當用戶將要對該對象制作一個控件選中區(qū)時觸發(fā)。
ondeactivate	當 activeElement 從當前對象變?yōu)楦肝臋n其它對象時觸發(fā)。
onerror	當對象裝載過程中發(fā)生錯誤時觸發(fā)。
onfocus	當對象獲得焦點時觸發(fā)。
onhelp	當用戶在瀏覽器為當前窗口時按 F1 鍵時觸發(fā)。
onload	在瀏覽器完成對象的裝載后立即觸發(fā)。
onmove	當對象移動時觸發(fā)。
onmoveend	當對象停止移動時觸發(fā)。
onmovestart	當對象開始移動時觸發(fā)。
onresize	當對象的大小將要改變時觸發(fā)。
onresizeend	當用戶更改完控件選中區(qū)中對象的尺寸時觸發(fā)。
onresizestart	當用戶開始更改控件選中區(qū)中對象的尺寸時觸發(fā)。
onscroll	當用戶滾動對象的滾動條時觸發(fā)。
onunload	在對象卸載前立即觸發(fā)。

方法

方法	描述
alert	顯示包含由應(yīng)用程序自定義消息的對話框。
attachEvent	將指定函數(shù)綁定到事件，以便每當該事件在對象上觸發(fā)時都調(diào)用該函數(shù)。
blur	使元素失去焦點并觸發(fā) onblur 事件。
clearInterval	使用 setInterval 方法取消先前開始的間隔事件。
clearTimeout	取消先前用 setTimeout 方法設(shè)置的超時事件。
close	關(guān)閉當前瀏覽器窗口或 HTML 應(yīng)用程序(HTA)。
confirm	顯示一個確認對話框，其中包含一個可選的消息和確定取消按鈕。
createPopup	創(chuàng)建彈出窗口。
detachEvent	從事件中取消指定函數(shù)的綁定，這樣當事件觸發(fā)時函數(shù)就不會收到通知了。
execScript	以給定語言執(zhí)行指定的腳本。
focus	使得元素得到焦點并執(zhí)行由 onfocus 事件指定的代碼。
moveBy	將窗口的位置移動指定 x 和 y 偏移值。
moveTo	將窗口左上角的屏幕位置移動到指定的 x 和 y 位置。
navigate	在當前窗口中裝入指定 URL。
open	打開新窗口并裝入給定 URL 的文檔。
print	打印與窗口關(guān)聯(lián)的文檔。
prompt	顯示一個提示對話框，其中帶有一條消息和一個輸入框。
resizeBy	更改窗口的當前位置縮放指定的 x 和 y 偏移量。
resizeTo	將窗口的大小更改為指定的寬度和高度值。
scroll	將窗口滾動到自左上角起指定的 x 和 y 偏移量。
scrollBy	將窗口滾動 x 和 y 偏移量。
scrollTo	將窗口滾動到指定的 x 和 y 偏移量。
setActive	設(shè)置對象為當前對象而不將對象置為焦點。
setInterval	每經(jīng)過指定毫秒值后計算一個表達式。
setTimeout	經(jīng)過指定毫秒值后計算一個表達式。
showHelp	顯示幫助文件。此方法可用于 Microsoft HTML 幫助。
showModalDialog	創(chuàng)建一個顯示指定 HTML 文檔的模式對話框。
showModelessDialog	創(chuàng)建一個顯示指定 HTML 文檔的非模式對話框。

對象

對象	描述
clientInformation	包含關(guān)于 Web 瀏覽器的信息。
clipboardData	提供了對于預(yù)定義的剪貼板格式的訪問，以便在編輯操作中使用。
document	代表給定瀏覽器窗口中的 HTML 文檔。
event	代表事件狀態(tài)，如事件發(fā)生的元素，鍵盤狀態(tài)，鼠標位置和鼠標按鈕狀態(tài)。
external	允許訪問由 Microsoft® Internet Explorer 瀏覽器組件宿主應(yīng)用程序提供的附加對象模型。
history	包含了用戶已瀏覽的 URL 的信息。
location	包含關(guān)于當前 URL 的信息。
navigator	包含關(guān)于 Web 瀏覽器的信息。
screen	包含關(guān)于客戶屏幕和渲染能力的信息。

注釋

你可以使用 window 對象獲取關(guān)于窗口狀態(tài)的信息。你還可以使用此對象或的對窗口文檔、窗口中發(fā)生的事件和影響窗口的瀏覽器的訪問。

典型情況下，瀏覽器會在其打開一個 HTML 文檔時創(chuàng)建一個對應(yīng)的 window 對象。但是，如果一個文檔定義了一個或多個框架(即，包含一個或多個 frame 或 iframe 標簽)，瀏覽器就會為原始文檔創(chuàng)建一個 window 對象，再為每個框架創(chuàng)建額外的 window 對象。這些額外的對象是原始窗口的 子窗口，可能被原始窗口中發(fā)生的事件所影響。例如，關(guān)閉原始窗口將導(dǎo)致關(guān)閉全部子窗口。如果想要創(chuàng)建新窗口(以及對應(yīng)的 window 對象)，可以使用像 open, showModalDialog 和 showModelessDialog 這樣的方法。

你可以對任何計算結(jié)果為 window 對象的變量或表達式應(yīng)用任何 window 的屬性、方法或集合，而不用管窗口是怎么創(chuàng)建的。除此以外，你可以在當前窗口中直接使用全部的屬性、方法和集合──也就是說，無需在前面附加計算結(jié)果為當前 window 對象的表達式。但是，為了使得代碼更加便于閱讀以及避免潛在的漏洞，許多作者在訪問當前窗口的屬性、方法和集合時使用 window 關(guān)鍵字。此關(guān)鍵字總是代表當前窗口。

注意 窗口的屬性、方法和集合的名稱都是保留關(guān)鍵字，無法用于變量或例程的名稱。

下面的表格列出了 window 對象某些屬性的相關(guān)信息。

屬性	方法	描述
opener	open	opener 屬性僅在使用 window.open 方法打開的頁面中可用。
parent, top	無	parent 和 top 屬性對 frame 或 iframe 內(nèi)打開的窗口可用。這兩個屬性分別返回立即父窗口和最上層的祖先窗口。
parent, top	open	parent 和 top 屬性對于通過 open 方法打開或以對話框打開并返回到當前窗口的窗口可用。
length	無	不管窗口是怎么打開的，length 屬性總是返回窗口中的框架數(shù)目。
dialogArguments, dialogHeight, dialogLeft, dialogTop, dialogWidth, returnValue	showModalDialog 和 showModelessDialog	這些屬性僅對用列出的兩個方法showModalDialog 和 showModelessDialog 打開的窗口可用。

此對象在 Microsoft^® Internet Explorer 3.0 的腳本中可用。

示例

下面的例子在當前窗口顯示了警告框。

alert("簡單的消息。")

下面的示例檢查當前窗口是否包含子窗口，如果是的話，顯示這些子窗口的名稱。

if ( window.frames != null ) {
for ( i = 0; i< window.frames.length; i++ )
window.alert ("子窗口 " +i+ " 的名稱為 "+window.frames(i).name);
}

下面的示例顯示了窗口 onload 事件的簡單事件處理句柄。由于沒有“window”元素，body 元素將作為下列 window 對象事件的宿主：onblur, onbeforeunload, onfocus, onload 和 onunload。

<BODY onload="window.status='頁面已裝載!'">

標準信息

此對象定義在 HTML 3.2  中。