onreadystatechange event
Fires when the state of the object has changed.
Syntax
HTML Attribute | <element onreadystatechange = "handler(event)"> |
Event Property | object.onreadystatechange = handler; |
attachEvent Method | object.attachEvent("onreadystatechange", handler) |
addEventListener Method | object.addEventListener("readystatechange", handler, useCapture) |
Event information
Synchronous | No |
Bubbles | No |
Cancelable | No |
Event handler parameters
- pEvtObj [in]
Type: IHTMLEventObj
Standards information
There are no standards that apply here.
Remarks
You can use the IHTMLLinkElement::readyState property to query the current state of the element when the HTMLDocumentEvents::onreadystatechange event fires.
All elements expose an HTMLDocumentEvents::onreadystatechange event. The following objects always fire the event because they load data: applet, document, frame, frameSet, iframe, img, link, object, script, and xml elements. Other objects will only fire the HTMLDocumentEvents::onreadystatechange event when a DHTML Behavior is attached.
Note For the script element, HTMLDocumentEvents::onreadystatechange is no longer supported. Starting with Internet Explorer 11, use HTMLFrameSiteEvents::onload. For info, see Compatibility changes.
When working with behaviors, wait for the HTMLDocumentEvents::onreadystatechange event to fire and verify that the IHTMLLinkElement::readyState property of the element is set to complete to ensure that the behavior is completely downloaded and applied to the element. Until the HTMLDocumentEvents::onreadystatechange event fires, if you use any of the behavior-defined members before attaching the behavior to the element, a scripting error can result, indicating that the object does not support that particular property or method.
Signals the ready state of the document.
To invoke this event, do one of the following:
- Change the ready state.
The pEvtObj parameter is required for the following interfaces:
- HTMLAnchorEvents2
- HTMLAreaEvents2
- HTMLButtonElementEvents2
- HTMLControlElementEvents2
- HTMLDocumentEvents2
- HTMLElementEvents2
- HTMLFormElementEvents2
- HTMLImgEvents2
- HTMLFrameSiteEvents2
- HTMLInputFileElementEvents2
- HTMLInputImageEvents2
- HTMLInputTextElementEvents2
- HTMLLabelEvents2
- HTMLLinkElementEvents2
- HTMLMapEvents2
- HTMLMarqueeElementEvents2
- HTMLObjectElementEvents2
- HTMLOptionButtonElementEvents2
- HTMLScriptEvents2
- HTMLSelectElementEvents2
- HTMLStyleElementEvents2
- HTMLTableEvents2
- HTMLTextContainerEvents2
- HTMLWindowEvents2
See also
Reference
Conceptual