Windowオブジェクト

Windowオブジェクト

windowオブジェクトはブラウザで開かれたウィンドウを表します。

ドキュメントにフレーム(<iframe>タグ)が含まれている場合、ブラウザはHTMLドキュメントにウィンドウオブジェクトを作成し、各フレームに追加のウィンドウオブジェクトを作成します。

Windowオブジェクト属性

オブジェクト 説明
closed ウィンドウが閉じられているかどうかを返します。
console ウィンドウの Consoleオブジェクト
defaultStatus 廃止されました。ウィンドウのステータスバーにデフォルトのテキストを設定または返します。
document ウィンドウの Documentオブジェクト
frameElement ウィンドウ内で実行されているフレームを返します。
frames ウィンドウ内で実行されているすべてのウィンドウオブジェクトを返します。
history ウィンドウの Historyオブジェクト
innerHeight ウィンドウのドキュメント表示領域の高さを返します。
innerWidth ウィンドウのドキュメント表示領域の幅を返します。
length 現在のウィンドウ内の<iframe>要素の数を返します。
localStorage Webブラウザでキー/値ペアを保存することができます。有効期限のないデータを保存します。
location ウィンドウの Location オブジェクト
name ウィンドウの名前を設定または返します。
navigator ウィンドウの Navigator オブジェクト
opener ウィンドウを作成したウィンドウの参照を返します。
outerHeight ツールバー/スクロールバーを含むブラウザウィンドウの高さを返します。
outerWidth ツールバー/スクロールバーを含むブラウザウィンドウの幅を返します。
pageXOffset 現在のドキュメントがウィンドウの左上隅(横)にスクロールしたピクセル数を返します。
pageYOffset 現在のドキュメントがウィンドウの左上隅(縦)にスクロールしたピクセル数を返します。
parent 現在のウィンドウの親ウィンドウを返します。
screen ウィンドウの Screen オブジェクト
screenLeft ウィンドウがスクリーンに対する水平座標を返します。
screenTop ウィンドウがスクリーンに対する垂直座標を返します。
screenX ウィンドウがスクリーンに対する水平座標を返します。
screenY ウィンドウがスクリーンに対する垂直座標を返します。
sessionStorage Web ブラウザでキー/値対を保存することができます。セッションのデータを保存します。
scrollX pageXOffset の別名
scrollY pageYOffset の別名
self 現在のウィンドウを返します。
status 廃止されました。使用を避けてください。
top 最上位のブラウザウィンドウを返します。

Window オブジェクトのメソッド

メソッド 説明
alert() メッセージと確定ボタンを含む警告ダイアログ(ダイアログ)を表示します。
atob() base-64エンコードされた文字列をデコードします。
blur() 現在のウィンドウから焦点を取り除きます。
btoa() base-64エンコードされた文字列です。
clearInterval() setInterval()で設定されたタイマーをクリアします。
clearTimeout() setTimeout()で設定されたタイマーをクリアします。
close() 現在のウィンドウを閉じます。
confirm() メッセージと確定およびキャンセルボタンを含むダイアログを表示します。
focus() 現在のウィンドウに焦点を設定します。
getComputedStyle() 指定されたドキュメント要素に適用される CSS スタイルを確定します。
getSelection() ユーザーが選択したテキスト範囲を表す Selection オブジェクトを返します。
matchMedia() 指定された CSS メディアクエリ文字列を表す MediaQueryList オブジェクトを返します。
moveBy() 現在の位置からウィンドウを移動します。
moveTo() ウィンドウを指定された位置に移動します。
open() 新しいブラウザウィンドウを開きます。
print() 現在のウィンドウの内容を印刷します。
prompt() 簡単な文字列の入力を求めるダイアログを使用します。
requestAnimationFrame() 次の再描画前にリクエストして、関数を呼び出してアニメーションを更新します。
resizeBy() 指定されたピクセルでウィンドウのサイズを調整します。
resizeTo() ウィンドウのサイズを指定された幅と高さに調整します。
scroll() 廃止されました。このメソッドは scrollTo() メソッド 置き換えます。
scrollBy() 指定のピクセル数でドキュメントをスクロールします。
scrollTo() 将文档滚动到指定坐标。
setInterval() 周期性执行指定的代码。
setTimeout() 在经过指定的时间之后执行代码。
stop() 停止加载窗口。

Window 对象描述

Window 对象表示浏览器窗口或框架。在客户端 JavaScript 中,Window 对象是全局对象,所有的表达式都在当前的环境中计算。也就是说,要引用当前窗口根本不需要特殊的语法,可以把那个窗口的属性作为全局变量来使用。例如,可以只写 document,而不必写 window.document。

同样,可以把当前窗口对象的方法当作函数来使用,如只写 alert(),而不必写 Window.alert()。

除了上面列出的属性和方法,Window 对象还实现了核心 JavaScript 所定义的所有全局属性和方法。

Window 对象的 window 属性和 self 属性引用的都是它自己。当你想明确地引用当前窗口,而不仅仅是隐式地引用它时,可以使用这两个属性。除了这两个属性之外,parent 属性、top 属性以及 frame[] 数组都引用了与当前 Window 对象相关的其他 Window 对象。

要引用窗口中的一个框架,可以使用如下语法:

frame[i]		//当前窗口的框架
self.frame[i]	//当前窗口的框架
w.frame[i]	//窗口 w 的框架

要引用一个框架的父窗口(或父框架),可以使用如下语法:

parent		//当前窗口的父窗口
self.parent	//当前窗口的父窗口
w.parent 		//窗口 w 的父窗口

要从顶层窗口含有的任何一个框架中引用它,可以使用如下语法:

top		//当前框架的顶层窗口
self.top		//当前框架的顶层窗口
f.top		//框架 f 的顶层窗口

新しいトップレベルのブラウザウィンドウは Window.open() メソッドで作成されます。このメソッドを呼び出す際には、open() の戻り値を変数に格納し、その変数を使用して新しいウィンドウを参照する必要があります。新しいウィンドウの opener 属性そのウィンドウを開いたウィンドウを逆引用します。

一般的に、Window オブジェクトのメソッドはブラウザのウィンドウやフレームに対して某种操作を行います。そして alert() メソッドconfirm() メソッドおよび prompt メソッド異なる場合、ユーザーと簡単なダイアログで交互にします。