## .resize( handler )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 )

  - handler
    Type: Function( Event eventObject )
    A function to execute each time the event is triggered.

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

  - eventData
    Type: Anything
    An object containing data that will be passed to the event handler.
  - handler
    Type: Function( Event eventObject )
    A function to execute each time the event is triggered.

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

  - This signature does not accept any arguments.

This method is a shortcut for `.on('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:

1 2 3 |
    $( 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).

### Additional Notes:

- As the `.resize()` method is just a shorthand for `.on( "resize", handler )`, detaching is possible using `.off( "resize" )`.

## Example:

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

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