JavaScript/Windowオブジェクト
Windowオブジェクトはブラウザを操作するためのWebAPI。
自分で生成しなくてもあらかじめwindowという識別子で使える状態になっている。
Windowオブジェクトはグローバルオブジェクトという特別なものなので、windowを省略して使うことができる。
MDN: Window
画面制御に関するメソッド。
メソッド | 説明 |
---|---|
alert(str) | 指定した文字列を画面のダイアログに表示する。 |
confirm(str) | 指定した文字列と[OK][キャンセル]ボタンをダイアログに表示する。 [OK]が押された場合はtrueが返される。 |
prompt(question [, default]) | 指定した文字列とテキスト入力欄をダイアログに表示する。 テキスト入力欄のデフォルト値はdefaultで指定可能。 入力された文字が戻り値となる。 |
close() | 現在表示中のウィンドウを閉じる。 |
open(url [, windowName, windowFeatures]) | urlで指定したページをwindowNameで指定した画面で開く。 新しい画面で開くには、_blankを指定する。 windowFeaturesで表示位置や大きさを指定可能。 |
scrollBy(x, y) | 現在の位置を基準に水平方向(x)、垂直方向(y)へスクロールする。 |
scrollBy(option) | 現在の位置を基準にオブジェクト形式で指定した位置へスクロールする。 ・top: 垂直方向 ・left: 水平方向 ・behavior: auto、instant、smoothのいずれか |
scroll(x-coord, y-coord) scrollTo(x-coord, y-coord) | HTMLの左上を基準に水平方向(x)、垂直方向(y)へスクロールする。 |
scroll(option) scrollTo(option) | HTMLの左上を基準にオブジェクト形式で指定した位置へスクロールする。 ・top: 垂直方向 ・left: 水平方向 ・behavior: auto、instant、smoothのいずれか |
タスク制御に関するメソッド。
メソッド | 説明 |
---|---|
setTimeout(fn [, delay, arg1, arg2, ...]) | 関数fnをdelayミリ秒後に実行するタスクを登録する。 argで渡した引数は関数fnに渡される。 戻り値としてtimeoutIDが返る。 |
setInterval(fn [, interval, arg1, arg2, ...]) | 関数fnをintervalミリ秒毎に実行するタスクを登録する。 argで渡した引数は関数fnに渡される。 戻り値としてintervalIDが返る。 |
requestAnimationFrame(fn) | 関数fnの実行を次の再描画の前に行うタスクを登録する。 |
queueMicrotask(fn) | 関数fnをマイクロタスク(ジョブキュー)に登録する。 |
clearTimeout(timeoutID) | timeoutIDのタスクをキャンセルする。 |
clearInterval(intervalID) | intervalIDのタスクをキャンセルする。 |
cancelAnimationFrame(requestID) | requestIDのタスクをキャンセルする。 |
その他のメソッド。
メソッド | 説明 |
---|---|
btoa(str) | 文字列をBase64形式のエンコード文字列に変換する。 |
atob(encodedStr) | Base64形式のエンコード文字列を文字列に変換する。 |
postMessage(message, targetOrigin [, transfer]) | Windowオブジェクト間のメッセージのやり取りを行う。 |
画面に関するプロパティ。
プロパティ | 説明 |
---|---|
innerWidth | スクロールバーを含む、ブラウザウィンドウの描画領域の横幅。 |
innerHeight | スクロールバーを含む、ブラウザウィンドウの描画領域の高さ。 |
outerWidth | メニューバーなどを含めたブラウザウィンドウ全体の横幅。 |
outerHeight | メニューバーなどを含めたブラウザウィンドウ全体の高さ。 |
pageXOffset | 水平方向へのスクロール量。 |
scrollX | |
pageYOffset | 垂直方向へのスクロール量。 |
scrollY | |
screenLeft | ディスプレイに対するブラウザウィンドウの水平方向の位置。 |
screenX | |
screenTop | ディスプレイに対するブラウザウィンドウの垂直方向の位置。 |
screenY |
Windowオブジェクトに関するプロパティ。
プロパティ | 説明 |
---|---|
self | Windowオブジェクトのエイリアス。 |
frames | window内のiframeを配列風オブジェクトとして返す。 |
parent | 現在のwindowの親のWindowオブジェクトを返す。 |
top | ウィンドウの階層で最上位のWindowオブジェクトを返す。 |