Window オブジェクト

Window オブジェクト

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

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

注釈：ウィンドウオブジェクトに適用される公式標準はありませんが、すべてのブラウザがこのオブジェクトをサポートしています。

Window オブジェクトコレクション

集合 説明
frames[]

ウィンドウ内のすべての名前付きフレームを返します。

このコレクションは Window オブジェクトの配列で、各 Window オブジェクトはウィンドウ内にフレームや <iframe> を含んでいます。属性 frames.length は配列 frames[] に含まれる要素の数を保存します。注意：frames[] 配列で参照されるフレームには、フレーム自体も frames[] 配列を持つ可能性があります。

Window オブジェクト属性

属性 説明
closed ウィンドウが閉じられているかどうかを返します。
defaultStatus ウィンドウのステータスバーのデフォルトテキストを設定または返します。
document Document オブジェクトの読み取り専用参照。参照してください。 Document オブジェクト。
Document オブジェクトの読み取り専用参照。参照してください。 Document オブジェクト History オブジェクト。
history ウィンドウのドキュメント表示領域の高さを返します。
innerwidth ウィンドウのドキュメント表示領域の幅を返します。
length ウィンドウ内のフレームの数を設定または返します。
location ウィンドウやフレームの Location オブジェクトを使用します。参照してください。 Location オブジェクト。
name ウィンドウの名前を設定または返します。
Navigator Navigator オブジェクトの読み取り専用参照。引数として指定してください。 Navigator オブジェクト。
opener このウィンドウを作成したウィンドウへの参照を返します。
outerheight ウィンドウの外部高さを返します。
outerwidth ウィンドウの外部幅を返します。
pageXOffset 現在のページがウィンドウの表示領域の左上角に対しての X 座標を設定または返します。
pageYOffset 現在のページがウィンドウの表示領域の左上角に対しての Y 座標を設定または返します。
parent 親ウィンドウを返します。
Screen Screen オブジェクトの読み取り専用参照。引数として指定してください。 Screen オブジェクト。
self 現在のウィンドウへの参照を返します。Window 属性と等価です。
status ウィンドウのステータスバーのテキストを設定します。
top 最上位の親ウィンドウを返します。
window window 属性は self 属性と等価で、ウィンドウ自身への参照を含んでいます。
  • screenLeft
  • screenTop
  • screenX
  • screenY
 整数読み取り専用。ウィンドウの左上角がスクリーン上の x 座標と y 座標を宣言しています。IE、Safari、Opera は screenLeft と screenTop をサポートし、Firefox と Safari は screenX と screenY をサポートします。

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

メソッド 説明
alert() メッセージと確認ボタンを含む警告ボックスを表示します。
blur() トップレベルウィンドウからキーボードの焦点を外します。
clearInterval() setInterval() で設定された timeout をキャンセルします。
clearTimeout() setTimeout() メソッドで設定された timeout をキャンセルします。
close() ブラウザのウィンドウを閉じます。
confirm() メッセージと確認ボタン、キャンセルボタンを含むダイアログを表示します。
createPopup() ポップアップウィンドウを作成します。
focus() キーボードの焦点をウィンドウに与えます。
moveBy() 現在のウィンドウの座標に対して指定されたピクセルで移動します。
moveTo() ウィンドウの左上角を指定された座標に移動します。
open() 新しいブラウザのウィンドウを開いたり、既に名前が付けられたウィンドウを検索します。
print() 現在のウィンドウの内容を印刷します。
prompt() ユーザーに入力を促すダイアログを表示します。
resizeBy() 指定されたピクセルでウィンドウの大きさを調整します。
resizeTo() ウィンドウの大きさを指定された幅と高さに調整します。
scrollBy() 指定されたピクセル値で内容をスクロールします。
scrollTo() 指定された座標に内容をスクロールします。
setInterval() 指定された周期（ミリ秒で計算）で関数や計算式を呼び出します。
setTimeout() 指定されたミリ秒数後に関数や計算式を呼び出します。

Window オブジェクトの説明

Window オブジェクトはブラウザのウィンドウやフレームを表します。クライアント-side 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 メソッドそれらはユーザーと簡単なダイアログで対話を行います。