resize event | jQuery API Documentation

resize event

Categories: Events > Browser Events
Bind an event handler to the "resize" event, or trigger that event on an element.

Contents:

.on( "resize" [, eventData ], handler )Returns: jQuery

Description: Bind an event handler to the "resize" event.

This page describes the resize event. For the deprecated .resize() method, see .resize().

The resize event is sent to the window element when the size of the browser window changes:

1
2
3
 
$( window ).on( "resize", function() {
  $( "#log" ).append( "<div>Handler for `resize` called.</div>" );
} );

Now whenever the browser window's size is changed, the message is appended to <div id="log"> one or more times, depending on the browser.

Code in a resize handler should never rely on the number of times the handler is called. Depending on implementation, resize events can be sent continuously as the resizing is in progress (the typical behavior in Internet Explorer and WebKit-based browsers such as Safari and Chrome), or only once at the end of the resize operation (the typical behavior in some other browsers such as Opera).

Example:

To see the window width while (or after) it is resized, try:

1
2
3
 
$( window ).on( "resize", function() {
  $( "body" ).prepend( "<div>" + $( window ).width() + "</div>" );
} );