Window.innerHeight
innerHeight は Window インターフェイスの読み取り専用プロパティで、ウィンドウの内部の高さをピクセル単位で返します。水平スクロールバーがあれば、その高さを含みます。
innerHeight の値はウィンドウのレイアウトビューポート (en-US)の高さから取られます。幅は innerWidth プロパティを使用して取ることができます。
構文
let intViewportHeight = window.innerHeight;
値
整数値で、ウィンドウのレイアウトビューポートの高さをピクセル単位で示します。このプロパティは読み取り専用で、既定値はありません。
ウィンドウの幅を変更するには、 resizeTo() や resizeBy() などの寸法変更メソッドの一つを呼び出してください。
使用上の注意
ウィンドウから水平スクロールバーや境界を引いた高さを取得するには、ルートの <html> 要素の clientHeight() プロパティを代わりに使用してください。
innerHeight および innerWidth はすべてのウィンドウと、ウィンドウのように動作するすべてのオブジェクト、例えばタブやフレームで利用できます。
例
フレームセットの想定
var intFrameHeight = window.innerHeight; // or
var intFrameHeight = self.innerHeight;
// フレームセット内にあるフレームのビューポートの高さを返します
var intFramesetHeight = parent.innerHeight;
// 最も近いフレームセットのビューポートの高さを返します
var intOuterFramesetHeight = top.innerHeight;
// もっとも外側のフレームセットのビューポートの高さを返します
FIXME: link to an interactive demo here
ウィンドウの寸法を変更するには、 window.resizeBy() と window.resizeTo() を参照してください。
ウィンドウの外形の高さ、すなわちブラウザーウィンドウ全体の高さを取得するには、 window.outerHeight を参照してください。
図
以下の図は outerHeight と innerHeight の違いを示しています。
仕様書
| 仕様書 | 状態 | 備考 |
|---|---|---|
| CSS Object Model (CSSOM) View Module window.innerHeight の定義 |
草案 | 初回定義 |
ブラウザーの互換性
BCD tables only load in the browser