window 對(duì)象

代表瀏覽器中一個(gè)打開(kāi)的窗口。

成員表

下面的表格列出了 window 對(duì)象引出的成員。請(qǐng)單擊左側(cè)的標(biāo)簽來(lái)選擇你想要查看的成員類(lèi)型。

屬性

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

集合

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

事件

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

方法

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

對(duì)象

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

注釋

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

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

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

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

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

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

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

示例

下面的例子在當(dāng)前窗口顯示了警告框。

alert("簡(jiǎn)單的消息。")

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

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

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

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

標(biāo)準(zhǔn)信息

此對(duì)象定義在 HTML 3.2  中。