t:BEGINEVENT Attribute | beginEvent Property (deprecated)
This page documents a feature of HTML+TIME 1.0, which was released in Microsoft® Internet Explorer 5. We recommend that you migrate your content to the latest version of HTML+TIME, which implements the SMIL 2.0 Working Draft. See the Introduction to HTML+TIME overview for more information.
Sets or gets a value that starts the timeline of an element when the referenced event occurs.
XML <ELEMENT t:BEGINEVENT = sEventName... > Scripting [ sEventName = ] object.beginEvent
sEventName String that specifies or receives one of the following values:
- A String that specifies a timing event or an event supported by the Dynamic HTML (DHTML) Object Model.
- Default. Value that specifies the element timeline is not started when a particular event occurs.
The property is read/write. The property has a default value of none.
This property supports interactive timing, where element timelines can begin in response to events from users, media players, or the presentation. You can offset the start time by specifying a nonzero value for the t:BEGIN attribute on the element. This indicates that the timeline should start a specified amount of time after the referenced event occurs. If the referenced event doesn't occur, the timeline on the current element does not start. This property cannot be used on the same element as the t:BEGINAFTER attribute or the t:BEGINWITH attribute.
To start the timeline on the current element, you can specify more than one event setting the t:BEGINEVENT attribute to a string containing a list of semicolon-separated events. For example, you can use the following code to cause the timeline to begin on the heading when either button is pressed.<BUTTON ID="btn1">Button #1</BUTTON> <BUTTON ID="btn2">Button #2</BUTTON> . . . <H1 CLASS="time" t:BEGINEVENT="btn1.onclick;btn2.onclick" t:DUR="5"> My Heading </H1>
t:prefix is used to associate this attribute with an XML namespace.