# .resize()

Categories: Events > Browser Events

## .resize( handler(eventObject) ) Returns: jQuery

Description: Bind an event handler to the "resize" JavaScript event, or trigger that event on an element.

- #### version added: 1.0.resize( handler(eventObject) )

  handler(eventObject)A function to execute each time the event is triggered.

- #### version added: 1.4.3.resize( [eventData], handler(eventObject) )

  eventDataA map of data that will be passed to the event handler.

  handler(eventObject)A function to execute each time the event is triggered.

- #### version added: 1.0.resize()

This method is a shortcut for `.bind('resize', handler)` in the first and second variations, and `.trigger('resize')` in the third.

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

    $(window).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:

    $(window).resize(function() {
      $('body').prepend('<div>' + $(window).width() + '</div>');
    });