Window: innerHeight property
BaselineWidely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
The read-onlyinnerHeight
property of theWindow
interface returns the interior height of the window in pixels,including the height of the horizontal scroll bar, if present.
The value ofinnerHeight
is taken from the height of the window'slayout viewport. The width can be obtained using theinnerWidth
property.
Value
An integer value indicating the window's layout viewport height in pixels. The propertyis read only and has no default value.
To change the height of the window, call one of its resize methods, such asresizeTo()
orresizeBy()
.
Usage notes
To obtain the height of the window minus its horizontal scroll bar and any borders, usethe root<html>
element'sclientHeight
property instead.
BothinnerHeight
andinnerWidth
are available on any windowor any object that behaves like a window, such as a tab or frame.
Examples
Assuming a frameset
console.log(window.innerHeight); // orconsole.log(self.innerHeight);// will log the height of the frame viewport within the framesetconsole.log(parent.innerHeight);// will log the height of the viewport of the closest framesetconsole.log(top.innerHeight);// will log the height of the viewport of the outermost frameset
To change the size of a window, seewindow.resizeBy()
andwindow.resizeTo()
.
To get the outer height of a window, i.e., the height of the whole browser window, seewindow.outerHeight
.
Graphical example
The following figure shows the difference betweenouterHeight
andinnerHeight
.
Demo
HTML
<p>Resize the browser window to fire the <code>resize</code> event.</p><p>Window height: <span></span></p><p>Window width: <span></span></p>
JavaScript
const heightOutput = document.querySelector("#height");const widthOutput = document.querySelector("#width");function updateSize() { heightOutput.textContent = window.innerHeight; widthOutput.textContent = window.innerWidth;}updateSize();window.addEventListener("resize", updateSize);
Result
You can alsoview the results of the demo code in a separate page.
Specifications
Specification |
---|
CSSOM View Module # dom-window-innerheight |