onpropertychange event

[This documentation is preliminary and is subject to change.]

Fires when a property changes on the object.


HTML Attribute <element onpropertychange = "handler(event)">
Event Property object.onpropertychange = handler;
attachEvent Method object.attachEvent("onpropertychange", handler)

Standards information

There are no standards that apply here.

Event information

Synchronous No
Bubbles No
Cancelable No

Event handler parameters


The onpropertychange event fires when properties of an object, expando, or style sub-object change. To retrieve the name of the changed property, use the event object's propertyName property. This property returns a read-only string of the name of the property that has changed. In the case of Cascading Style Sheets (CSS) properties, the property name is prefixed with style. For example, if the CSS property pixelLeft is altered, the value of window.event.propertyName is style.left. By contrast, if the non-CSS property name is altered, the value of window.event.propertyName is name.

When the onpropertychange event fires, the srcElement property of the event object is set to the object whose property has changed.

Note  Changing the innerText or innerHTML of child elements will not cause the onpropertychange event to fire for the parent element.

Sends notification when a property changes.

To invoke this event, do one of the following:

  • Cause a property to change value.

The pEvtObj parameter is required for the following interfaces:

See also






Build date: 1/23/2012