Export (0) Print
Expand All
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

resize | onresize event

Fires when the size of the object is about to change.

Syntax

HTML Attribute <element onresize = "handler(event)">
Event Property object.onresize = handler;

 

Event information

SynchronousNo
BubblesNo
CancelableNo

 

Event handler parameters

pEvtObj [in]

Type: Varies (see Remarks)

Standards information

There are no standards that apply here.

Remarks

Starting with a Windows Store app using JavaScript, the behavior of the resize event varies according to the document mode of the webpage and the registration of the event.

For webpages displayed in IE9 standards mode or later (including interoperable quirks mode), the resize event behaves according to the W3C DOM Level 3 events standards. In earlier versions of the browser (and corresponding documents modes), the resize event is a legacy, proprietary event associated with element document objects.

In practice, this means the following: As a result, the behavior of the resize event depends on two factors: the document mode of the webpage and

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 a 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 a legacy event object supported by a Windows Store app using JavaScript and 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 a legacy event object.
  • For pages displayed in legacy document modes (a Windows Store app using JavaScript and earlier), the event object is a legacy event object..
  • When the event is fired in the context of a Windows Store app using JavaScript, the event object is a standards based Event object.

For best results, we recommend using addEventListener to register your event handlers. This means you'll use the window object, rather than any element object:


window.addEventListener("resize", handler, useCapture); 

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.

To invoke this event, change the height or width of the object.

In Windows 8.1 versions, the resize event fires when the window size changes or when one of the following properties changes:

You can use the resize event to listen for changes to the size or position of the current window.

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
bgSound
blockQuote
body
br
button
caption
cite
code
col
colGroup
comment
custom
dd
del
dfn
div
dl
dt
em
embed
fieldSet
form
frame
head
hn
hr
html
i
iframe
img
input type=button
input type=checkbox
input type=email
input type=file
input type=hidden
input type=image
input type=number
input type=password
input type=radio
input type=range
input type=reset
input type=search
input type=submit
input type=tel
input type=text
input type=url
ins
kbd
label
legend
li
link
map
menu
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

 

 

Show:
© 2015 Microsoft