Fires when the size of the object is about to change.
Syntax
| HTML Attribute | <element onresize = "handler(event)"> |
|---|---|
| Event Property | object.onresize = handler; |
| addEventListener Method | object.addEventListener("resize", handler, useCapture) |
Event information
| Synchronous | No |
|---|---|
| Bubbles | No |
| Cancelable | No |
Event handler parameters
- pEvtObj [in]
-
Type: Varies (see Remarks)
Standards information
There are no standards that apply here.
Remarks
As of a Windows Store app using JavaScript, the type of the event object passed to a function handling the resize event varies:
- When the event is fired from the window object, the event object is an Event object; that is, it is the standards-based event object.
- When the event is fired from an element and the handler was assigned using addEventListener, the event object is a Event object; that is, it is the standards-based event object.
- When the event is fired from an element and the handler was assigned using the onresize attribute, the event object is an event object, which is the legacy event supported by earlier versions of a Windows Store app using JavaScript.
- When the event is fired from an element and the handler was assigned using the attachEvent method, the event object is an event object, which is the legacy event supported by earlier versions of a Windows Store app using JavaScript.
- For pages displayed in legacy document modes (a Windows Store app using JavaScript and earlier), the event object is an event object, which is the legacy event supported by earlier versions of a Windows Store app using JavaScript.
- When the event is fired in the context of a Windows Store app using JavaScript, the event object is an Event object; that is, it is the standards-based event object.
For best results, we recommend using addEventListener to register your event handlers.
The onresize event fires for block and inline objects with layout, even if document or CSS (cascading style sheets) property values are changed. Objects have layout when measurements such as the height and width attributes are set, or when the position of the object is set. Intrinsic objects, such as button, and windowed objects, such as window and iframe, fire as expected. This event does not fire for files with embedded controls.
Resizing HTML applications also fires the resize event.
No default action.
To invoke this event, do one of the following:
- Change the height or width of the object.
window.onresize events in Windows Store apps using JavaScript
In Windows Store apps using JavaScript, the window.onresize event fires when the screen keyboard is shown and when the app's viewport is resized. You can use the window.innerHeight, window.innerWidth, window.pageXOffset, and window.pageYOffset style properties to determine the size and location of the new viewport.
See also
- a
- abbr
- address
- area
- b
- base
- bdo
- blockQuote
- body
- br
- button
- caption
- cite
- code
- col
- colGroup
- comment
- custom
- dd
- del
- div
- dl
- dt
- em
- embed
- fieldSet
- form
- head
- hn
- hr
- html
- i
- iframe
- img
- input type=button
- input type=checkbox
- input type=file
- input type=hidden
- input type=image
- input type=password
- input type=radio
- input type=reset
- input type=submit
- input type=text
- ins
- kbd
- label
- legend
- li
- link
- map
- object
- ol
- option
- p
- pre
- q
- rt
- ruby
- s
- samp
- script
- select
- small
- span
- strong
- sub
- sup
- table
- tBody
- td
- textArea
- tFoot
- th
- tHead
- title
- tr
- u
- ul
- var
Send comments about this topic to Microsoft
Build date: 11/29/2012