724

How can I hook into a browser window resize event?

There's a jQuery way of listening for resize events but I would prefer not to bring it into my project for just this one requirement.

1
  • 9
    Thanks everyone. I dont care about IE, I was thinking more about resizing for opera on a mobile phone. Mar 13, 2009 at 9:04

12 Answers 12

776

Best practice is to add to the resize event, rather than replace it:

window.addEventListener('resize', function(event) {
    ...
}, true);

An alternative is to make a single handler for the DOM event (but can only have one), eg.

window.onresize = function(event) {
    ...
};

jQuery may do some work to ensure that the resize event gets fired consistently in all browsers, but I'm not sure if any of the browsers differ, but I'd encourage you to test in Firefox, Safari, and IE.

16
  • 239
    One potential gotcha with this method is that you're overriding the event and so you can't attach multiple actions to an event. The addEventListener/attachEvent combo is the best way to go to make your javascript play friendly with any other script that might be executing on the page. Jun 21, 2011 at 20:20
  • 4
    var onresize = window.onresize; window.onresize = function(event) { if (typeof onresize === 'function') onresize(); /** ... */ }
    – SubOne
    Jul 17, 2012 at 0:58
  • 249
    window.addEventListener('resize', function(){}, true); Nov 7, 2014 at 16:57
  • 19
    @SubOne a perfect example of how one should never do it. Feb 10, 2016 at 16:58
  • 36
    ECMAScript 6: window.onresize = () => { /* code */ }; or better: window.addEventListener('resize', () => { /* code */ }); Jul 12, 2017 at 21:54
631

First off, I know the addEventListener method has been mentioned in the comments above, but I didn't see any code. Since it's the preferred approach, here it is:

window.addEventListener('resize', function(event){
  // do stuff here
});

Here's a working sample.

7
  • 70
    This is the most straightforward answer.
    – jacoviza
    Apr 9, 2014 at 17:49
  • 7
    Sounds like the best answer because your not overwriting the window.onresize event :-) May 8, 2015 at 14:53
  • 34
    Many people add anonymous event listeners like you do in this example, but it is not really good practice, because this approach makes it impossible to remove these listeners later. This used to be no problem because web pages were short-lived anyway, but in this day and age of AJAX and RIAs and SPAs it's becoming one. We need a way to manage event listeners lifecycle. Thus, It would be better to factor out the listener function into a separate function so it can be removed later with removeEventListener. Jun 19, 2016 at 14:30
  • 9
    why can't everyone answer like this without all the fluff
    – quemeful
    Aug 19, 2017 at 17:59
  • 2
    I think there is truth to both Stijn de Witt's and quemeful's answers here. Sometimes you care about removing event listeners, but in the case that you don't, adding all that extra code like in the example above is unnecessary and can both to bloat and less readability. In my opinion, if you don't envision a reason to need to remove the listener, this approach is the best solution. You can always rewrite it later if necessary. In my experience, these needs only arise in specific situations.
    – cazort
    Feb 22, 2019 at 15:57
544

Never override the window.onresize function.

Instead, create a function to add an Event Listener to the object or element. This checks and incase the listeners don't work, then it overrides the object's function as a last resort. This is the preferred method used in libraries such as jQuery.

object: the element or window object
type: resize, scroll (event type)
callback: the function reference

var addEvent = function(object, type, callback) {
    if (object == null || typeof(object) == 'undefined') return;
    if (object.addEventListener) {
        object.addEventListener(type, callback, false);
    } else if (object.attachEvent) {
        object.attachEvent("on" + type, callback);
    } else {
        object["on"+type] = callback;
    }
};

Then use is like this:

addEvent(window, "resize", function_reference);

or with an anonymous function:

addEvent(window, "resize", function(event) {
  console.log('resized');
});
17
  • 107
    This should have been the accepted answer. Overriding onresize is just bad practice.
    – oxygen
    Jun 11, 2012 at 10:05
  • 10
    hah, what's with all the extra null checks? trying to work in IE 4.5 or something? Sep 15, 2012 at 4:24
  • 2
    And you are wondering how do I call this function to receive window resize events? Here is how: addEvent(window, "resize", function_reference); :)
    – dev4life
    Feb 20, 2014 at 17:28
  • 6
    Note that as of IE 11, attachEvent is no longer supported. The preferred way for the future is addEventListener.
    – Luke
    Feb 26, 2014 at 23:26
  • 6
    Be careful with elem == undefined. It is possible (although unlikely) that "undefined" is locally defined as something else. stackoverflow.com/questions/8175673/…
    – Luke
    Feb 26, 2014 at 23:39
61

Solution for 2018+:

You should use ResizeObserver. It is a browser-native solution that has a much better performance than to use the resize event. In addition, it not only supports the event on the document but also on arbitrary elements.

var ro = new ResizeObserver( entries => {
  for (let entry of entries) {
    const cr = entry.contentRect;
    console.log('Element:', entry.target);
    console.log(`Element size: ${cr.width}px x ${cr.height}px`);
    console.log(`Element padding: ${cr.top}px ; ${cr.left}px`);
  }
});

// Observe one or multiple elements
ro.observe(someElement);

Currently, Firefox, Chrome, Safari, and Edge support it. For other (and older) browsers you have to use a polyfill.

2
  • any source for the claim "much better performance" please? (I'm not disproving, just asking :)) I know the window:resize fires a lot, but for a simple "if this then that" method it shouldn't slow app down, WDYT?
    – Tony
    Jan 16 at 15:48
  • According to MDN it only works on SVG elements.
    – chovy
    Mar 10 at 8:50
50

The resize event should never be used directly as it is fired continuously as we resize.

Use a debounce function to mitigate the excess calls.

window.addEventListener('resize',debounce(handler, delay, immediate),false);

Here's a common debounce floating around the net, though do look for more advanced ones as featuerd in lodash.

const debounce = (func, wait, immediate) => {
    var timeout;
    return () => {
        const context = this, args = arguments;
        const later = function() {
            timeout = null;
            if (!immediate) func.apply(context, args);
        };
        const callNow = immediate && !timeout;
        clearTimeout(timeout);
        timeout = setTimeout(later, wait);
        if (callNow) func.apply(context, args);
    };
};

This can be used like so...

window.addEventListener('resize', debounce(() => console.log('hello'),
200, false), false);

It will never fire more than once every 200ms.

For mobile orientation changes use:

window.addEventListener('orientationchange', () => console.log('hello'), false);

Here's a small library I put together to take care of this neatly.

5
  • I appreciate the information on: debounce (it now seems an invaluable concept/function even though I previously resisted using timeouts in this way), lodash (though I'm personally not convinced) and resolving the ambiguity about whether to use addEvent as a fallback to addEventListener (only because older answers don't really explicitly address the comments regarding this)
    – wunth
    Aug 14, 2017 at 0:03
  • 9
    FYI since you are using ES6 arrow func notation, the inner function needs to have (...arguments) => {...} (or ...args for less confusion) as the arguments variable is no longer available their scope. Sep 4, 2017 at 3:43
  • I'm fully aware, that snippet is not my code, it's just as an example. Sep 15, 2017 at 18:06
  • 1
    Great answer, the perf issues with resize need to be addressed! Debouncing is an option, another is simple throttling (which might be the way to go if you need your UI to resize in "steps"). See bencentra.com/code/2015/02/27/optimizing-window-resize.html for examples Oct 14, 2019 at 12:20
  • orientationchange is deprecated
    – Lukas
    Jan 6 at 13:44
17

I do believe that the correct answer has already been provided by @Alex V, yet the answer does require some modernization as it is over five years old now.

There are two main issues:

  1. Never use object as a parameter name. It is a reservered word. With this being said, @Alex V's provided function will not work in strict mode.

  2. The addEvent function provided by @Alex V does not return the event object if the addEventListener method is used. Another parameter should be added to the addEvent function to allow for this.

NOTE: The new parameter to addEvent has been made optional so that migrating to this new function version will not break any previous calls to this function. All legacy uses will be supported.

Here is the updated addEvent function with these changes:

/*
    function: addEvent

    @param: obj         (Object)(Required)

        -   The object which you wish
            to attach your event to.

    @param: type        (String)(Required)

        -   The type of event you
            wish to establish.

    @param: callback    (Function)(Required)

        -   The method you wish
            to be called by your
            event listener.

    @param: eventReturn (Boolean)(Optional)

        -   Whether you want the
            event object returned
            to your callback method.
*/
var addEvent = function(obj, type, callback, eventReturn)
{
    if(obj == null || typeof obj === 'undefined')
        return;

    if(obj.addEventListener)
        obj.addEventListener(type, callback, eventReturn ? true : false);
    else if(obj.attachEvent)
        obj.attachEvent("on" + type, callback);
    else
        obj["on" + type] = callback;
};

An example call to the new addEvent function:

var watch = function(evt)
{
    /*
        Older browser versions may return evt.srcElement
        Newer browser versions should return evt.currentTarget
    */
    var dimensions = {
        height: (evt.srcElement || evt.currentTarget).innerHeight,
        width: (evt.srcElement || evt.currentTarget).innerWidth
    };
};

addEvent(window, 'resize', watch, true);
2
  • I would argue that attachEvent is no longer relevant in 2017. Mar 17, 2017 at 7:10
  • @VladNicula I would agree, but this answer is two years old. Mar 17, 2017 at 20:03
6
window.onresize = function() {
    // your code
};
1
  • 25
    As many of the comments above say, it's best not to overwrite the onresize function; rather add a new event. See Jondlm's answer.
    – Luke
    Feb 26, 2014 at 23:20
5

The following blog post may be useful to you: Fixing the window resize event in IE

It provides this code:

Sys.Application.add_load(function(sender, args) {
    $addHandler(window, 'resize', window_resize);
});

var resizeTimeoutId;

function window_resize(e) {
     window.clearTimeout(resizeTimeoutId);
     resizeTimeoutId = window.setTimeout('doResizeCode();', 10);
}
1
  • 6
    This one is applicable to ASP.NET applications only May 9, 2014 at 20:13
3

The already mentioned solutions above will work if all you want to do is resize the window and window only. However, if you want to have the resize propagated to child elements, you will need to propagate the event yourself. Here's some example code to do it:

window.addEventListener("resize", function () {
  var recResizeElement = function (root) {
    Array.prototype.forEach.call(root.childNodes, function (el) {

      var resizeEvent = document.createEvent("HTMLEvents");
      resizeEvent.initEvent("resize", false, true);
      var propagate = el.dispatchEvent(resizeEvent);

      if (propagate)
        recResizeElement(el);
    });
  };
  recResizeElement(document.body);
});

Note that a child element can call

 event.preventDefault();

on the event object that is passed in as the first Arg of the resize event. For example:

var child1 = document.getElementById("child1");
child1.addEventListener("resize", function (event) {
  ...
  event.preventDefault();
});
2

You can use following approach which is ok for small projects

<body onresize="yourHandler(event)">

function yourHandler(e) {
  console.log('Resized:', e.target.innerWidth)
}
<body onresize="yourHandler(event)">
  Content... (resize browser to see)
</body>

1
<script language="javascript">
    window.onresize = function() {
    document.getElementById('ctl00_ContentPlaceHolder1_Accordion1').style.height = '100%';
} 

</script>
1
var EM = new events_managment();

EM.addEvent(window, 'resize', function(win,doc, event_){
    console.log('resized');
    //EM.removeEvent(win,doc, event_);
});

function events_managment(){
    this.events = {};
    this.addEvent = function(node, event_, func){
        if(node.addEventListener){
            if(event_ in this.events){
                node.addEventListener(event_, function(){
                    func(node, event_);
                    this.events[event_](win_doc, event_);
                }, true);
            }else{
                node.addEventListener(event_, function(){
                    func(node, event_);
                }, true);
            }
            this.events[event_] = func;
        }else if(node.attachEvent){

            var ie_event = 'on' + event_;
            if(ie_event in this.events){
                node.attachEvent(ie_event, function(){
                    func(node, ie_event);
                    this.events[ie_event]();
                });
            }else{
                node.attachEvent(ie_event, function(){
                    func(node, ie_event);
                });
            }
            this.events[ie_event] = func;
        }
    }
    this.removeEvent = function(node, event_){
        if(node.removeEventListener){
            node.removeEventListener(event_, this.events[event_], true);
            this.events[event_] = null;
            delete this.events[event_];
        }else if(node.detachEvent){
            node.detachEvent(event_, this.events[event_]);
            this.events[event_] = null;
            delete this.events[event_];
        }
    }
}

Not the answer you're looking for? Browse other questions tagged or ask your own question.