oncontentready Event

Internet Development Index

Fires when the content of the element, to which the behavior is attached, has been completely parsed.


EVENT = oncontentready
ONEVENT = sEventHandler
FOR = element
ID = sID


Required. String that specifies the name of a Dynamic HTML (DHTML) event, or any of the events specific to the HTML Component (HTC) that are listed in the HTC Reference.
Optional. String that specifies one of the following values to identify the source of the event.
documentRefers to the document object.
elementDefault. Refers to the element to which the behavior is attached.
windowRefers to the window object.
Optional. String that uniquely identifies the PUBLIC:ATTACH element within the component. This attribute is analogous to the ID attribute in Dynamic HTML (DHTML).
Required. String that specifies an inline script or a direct invocation of the event handler function.


The innerHTML property of the element might not return the correct value until this event fires.

When this event is fired and the literalContent attribute of the PUBLIC:COMPONENT element is true, the literal content of the Element Behavior has been stored in the innerHTML property. This event indicates to the element behavior that it can then access the innerHTML property.

Because this event is specific to HTC components, the only way to bind to the oncontentready event is by using the PUBLIC:ATTACH element. The attachEvent method does not bind to this event because it works with standard DHTML Events only. When an HTC file is implemented as a Viewlink, the oncontentready event, or any other event that is HTC-specific, cannot be attached to an element in the document fragment.

See Component Initialization for an overview of events fired during the initialization of an HTC file and its primary document.


This example uses the oncontentready event on a page to display the value of the element's innerHTML property.

<PUBLIC:ATTACH EVENT="oncontentready" ONEVENT="show_innerHTML()" />
function show_innerHTML()
window.alert ('innerHTML = ' + element.innerHTML);

See Also

Introduction to DHTML Behaviors, About Element Behaviors, Using HTML Components to Implement DHTML Behaviors in Script