The resize
event fires when the document view (window) has been resized.
Bubbles | No |
Cancelable | No |
Interface | UIEvent
|
Event handler property | onresize
|
In some earlier browsers it was possible to register resize
event handlers on any HTML element. It is still possible to set onresize
attributes or use addEventListener()
to set a handler on any element. However, resize
events are only fired on the window
object (i.e. returned by document.defaultView
). Only handlers registered on the window
object will receive resize
events.
There is a proposal to allow all elements to be notified of resize changes. See Resize Observer to read the draft document, and GitHub issues to read the on-going discussions.
Examples
Window size logger
The following example reports the window size each time it is resized. Bear in mind that since the example is running in an <iframe>
, you'll need to actually get the <iframe>
to resize before you see an effect.
<p>Resize the browser window to fire the <code>resize</code> event.</p>
<p>Window height: <span id="height"></span></p>
<p>Window width: <span id="width"></span></p>
const heightOutput = document.querySelector('#height');
const widthOutput = document.querySelector('#width');
function reportWindowSize() {
heightOutput.textContent = window.innerHeight;
widthOutput.textContent = window.innerWidth;
}
window.onresize = reportWindowSize;
addEventListener equivalent
You could set up the event handler using the addEventListener()
method:
window.addEventListener('resize', reportWindowSize);
Specifications
Browser compatibility
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
resize event
|
Chrome Full support 1 Full support 1 Notes' Chrome does not emit a |
Edge Full support 12 Full support 12 Notes' Prior to Edge 79, Edge emitted a |
Firefox Full support 1 Full support 1 Notes' Prior to Firefox 68, Firefox emitted a |
IE
Full support 4 |
Opera Full support 7 Full support 7 Notes' Opera does not emit a |
Safari
Full support 1.1 |
WebView Android Full support 1 Full support 1 Notes' Webview does not emit a |
Chrome Android Full support 18 Full support 18 Notes' Chrome does not emit a |
Firefox Android Full support 4 Full support 4 Notes' Prior to Firefox 68, Firefox emitted a |
Opera Android Full support 10.1 Full support 10.1 Notes' Opera does not emit a |
Safari iOS
Full support 1 |
Samsung Internet Android Full support 1.0 Full support 1.0 Notes' Samsung Internet does not emit a |
Legend
- Full support
- Full support
- See implementation notes.'
- See implementation notes.
See also
Window: resize event by Mozilla Contributors is licensed under CC-BY-SA 2.5.