Binds a function to an event, so that the function is called whenever the event fires on the specified object.
EVENT = "sEvent"
FOR = "sObject"
ID = "sID"
ONEVENT = "sEventHandler"
- 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.
document||Refers to the document object.|
element||Default. Refers to the element to which the behavior is attached.|
window||Refers 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 DHTML.
- Required. String that specifies an inline script or a direct invocation of the event handler function.
|Minimum availability||Internet Explorer
|Minimum operating systems||
Windows 95, Windows NT 4.0|
The PUBLIC:ATTACH element is a declarative form of the attachEvent method.
When the specified event fires on the element to which the behavior is attached, the element's event handler is called first, before the behavior's. If multiple behaviors are attached to an element and multiple event handlers are defined for the same event on the same element, the functions are called in random order, immediately after the element's event handler is called.
When providing a value for ONEVENT, avoid assigning the event handler function the name of an existing DHTML event. Using an existing DHTML event name might cause recursion errors.
Event names are case-sensitive for all scripted languages.
This example uses an HTC to implement a table of contents that expands and collapses. The HTC attaches to the element's onclick event, and then expands or collapses the list each time the onclick event is received.
<PUBLIC:PROPERTY NAME="child" />
<PUBLIC:ATTACH EVENT="onclick" ONEVENT="ExpandCollapse()" />
// Determine current state of the list (expanded or collapsed)
// based on the current display property of the child.
bCollapsed = (element.document.all(child).style.display == "none");
style.listStyleImage = "url('../common/blueminus.gif')";
element.document.all(child).style.display = "";
style.listStyleImage = "url('../common/blueplus.gif')";
element.document.all(child).style.display = "none";
This feature requires Microsoft® Internet Explorer 5 or later. Click the following icon to install the latest version. Then reload this page to view the sample.
Introduction to DHTML Behaviors, Using HTML Components to Implement DHTML Behaviors in Script