WBR 元素 | wbr 对象 XML 元素 | xml 对象 DHTML 对象
window 对象
代表浏览器中一个打开的窗口。
成员表
下面的表格列出了 window 对象引出的成员。请单击左侧的标签来选择你想要查看的成员类型。
属性
属性 描述 closed 获取引用窗口是否已关闭。 defaultStatus 设置或获取要在窗口底部的状态栏上显示的缺省信息。 dialogArguments 设置或获取传递给模式对话框窗口的变量或变量数组。 dialogHeight 设置或获取模式对话框的高度。 dialogLeft 设置或获取模式对话框的左坐标。 dialogTop 设置或获取模式对话框的顶坐标。 dialogWidth 设置或获取模式对话框的宽度。 frameElement 获取在父文档中生成 window 的 frame 或 iframe 对象。 length 设置或获取集合中对象的数目。 name 设置或获取表明窗口名称的值。 offscreenBuffering 设置或获取对象在对用户可见之前是否要先在屏幕外绘制。 opener 设置或获取创建当前窗口的窗口的引用。 parent 获取对象层次中的父窗口。 returnValue 设置或获取从模式对话框返回的值。 screenLeft 获取浏览器客户区左上角相对于屏幕左上角的 x 坐标。 screenTop 获取浏览器客户区左上角相对于屏幕左上角的 y 坐标。 self 获取对当前窗口或框架的引用。 status 设置或获取位于窗口底部状态栏的信息。 top 获取最顶层的祖先窗口。 集合
集合 描述 frames 获取给定文档定义或与给定窗口关联的文档定义的所有 window 对象的集合。 事件
事件 描述 onactivate 当对象设置为活动元素时触发。 onafterprint 对象所关联的文档打印或打印预览后立即在对象上触发。 onbeforedeactivate 在 activeElement 从当前对象变为父文档其它对象之前立即触发。 onbeforeprint 对象的关联文档打印或打印预览前在对象上触发。 onbeforeunload 在页面将要被卸载前触发。 onblur 在对象失去输入焦点时触发。 oncontrolselect 当用户将要对该对象制作一个控件选中区时触发。 ondeactivate 当 activeElement 从当前对象变为父文档其它对象时触发。 onerror 当对象装载过程中发生错误时触发。 onfocus 当对象获得焦点时触发。 onhelp 当用户在浏览器为当前窗口时按 F1 键时触发。 onload 在浏览器完成对象的装载后立即触发。 onmove 当对象移动时触发。 onmoveend 当对象停止移动时触发。 onmovestart 当对象开始移动时触发。 onresize 当对象的大小将要改变时触发。 onresizeend 当用户更改完控件选中区中对象的尺寸时触发。 onresizestart 当用户开始更改控件选中区中对象的尺寸时触发。 onscroll 当用户滚动对象的滚动条时触发。 onunload 在对象卸载前立即触发。 方法
方法 描述 alert 显示包含由应用程序自定义消息的对话框。 attachEvent 将指定函数绑定到事件,以便每当该事件在对象上触发时都调用该函数。 blur 使元素失去焦点并触发 onblur 事件。 clearInterval 使用 setInterval 方法取消先前开始的间隔事件。 clearTimeout 取消先前用 setTimeout 方法设置的超时事件。 close 关闭当前浏览器窗口或 HTML 应用程序(HTA)。 confirm 显示一个确认对话框,其中包含一个可选的消息和确定取消按钮。 createPopup 创建弹出窗口。 detachEvent 从事件中取消指定函数的绑定,这样当事件触发时函数就不会收到通知了。 execScript 以给定语言执行指定的脚本。 focus 使得元素得到焦点并执行由 onfocus 事件指定的代码。 moveBy 将窗口的位置移动指定 x 和 y 偏移值。 moveTo 将窗口左上角的屏幕位置移动到指定的 x 和 y 位置。 navigate 在当前窗口中装入指定 URL。 open 打开新窗口并装入给定 URL 的文档。 打印与窗口关联的文档。 prompt 显示一个提示对话框,其中带有一条消息和一个输入框。 resizeBy 更改窗口的当前位置缩放指定的 x 和 y 偏移量。 resizeTo 将窗口的大小更改为指定的宽度和高度值。 scroll 将窗口滚动到自左上角起指定的 x 和 y 偏移量。 scrollBy 将窗口滚动 x 和 y 偏移量。 scrollTo 将窗口滚动到指定的 x 和 y 偏移量。 setActive 设置对象为当前对象而不将对象置为焦点。 setInterval 每经过指定毫秒值后计算一个表达式。 setTimeout 经过指定毫秒值后计算一个表达式。 showHelp 显示帮助文件。此方法可用于 Microsoft HTML 帮助。 showModalDialog 创建一个显示指定 HTML 文档的模式对话框。 showModelessDialog 创建一个显示指定 HTML 文档的非模式对话框。 对象
对象 描述 clientInformation 包含关于 Web 浏览器的信息。 clipboardData 提供了对于预定义的剪贴板格式的访问,以便在编辑操作中使用。 document 代表给定浏览器窗口中的 HTML 文档。 event 代表事件状态,如事件发生的元素,键盘状态,鼠标位置和鼠标按钮状态。 external 允许访问由 Microsoft® Internet Explorer 浏览器组件宿主应用程序提供的附加对象模型。 history 包含了用户已浏览的 URL 的信息。 location 包含关于当前 URL 的信息。 navigator 包含关于 Web 浏览器的信息。 screen 包含关于客户屏幕和渲染能力的信息。
注释
你可以使用 window 对象获取关于窗口状态的信息。你还可以使用此对象或的对窗口文档、窗口中发生的事件和影响窗口的浏览器的访问。
典型情况下,浏览器会在其打开一个 HTML 文档时创建一个对应的 window 对象。但是,如果一个文档定义了一个或多个框架(即,包含一个或多个 frame 或 iframe 标签),浏览器就会为原始文档创建一个 window 对象,再为每个框架创建额外的 window 对象。这些额外的对象是原始窗口的 子窗口,可能被原始窗口中发生的事件所影响。例如,关闭原始窗口将导致关闭全部子窗口。如果想要创建新窗口(以及对应的 window 对象),可以使用像 open, showModalDialog 和 showModelessDialog 这样的方法。
你可以对任何计算结果为 window 对象的变量或表达式应用任何 window 的属性、方法或集合,而不用管窗口是怎么创建的。除此以外,你可以在当前窗口中直接使用全部的属性、方法和集合──也就是说,无需在前面附加计算结果为当前 window 对象的表达式。但是,为了使得代码更加便于阅读以及避免潜在的漏洞,许多作者在访问当前窗口的属性、方法和集合时使用 window 关键字。此关键字总是代表当前窗口。
注意 窗口的属性、方法和集合的名称都是保留关键字,无法用于变量或例程的名称。下面的表格列出了 window 对象某些属性的相关信息。
属性 方法 描述 opener open opener 属性仅在使用 window.open 方法打开的页面中可用。 parent, top 无 parent 和 top 属性对 frame 或 iframe 内打开的窗口可用。这两个属性分别返回立即父窗口和最上层的祖先窗口。 parent, top open parent 和 top 属性对于通过 open 方法打开或以对话框打开并返回到当前窗口的窗口可用。 length 无 不管窗口是怎么打开的,length 属性总是返回窗口中的框架数目。 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 中。