Provides an active timeline for an HTML element or group of elements.
Syntax
| XML |
<t:
PredefinedTag ID=sID STYLE="behavior:url('#default#time2')" />
|
|---|
| HTML |
<ELEMENT STYLE="behavior:url('#default#time2')" ID=sID> |
|---|
| Scripting | object.style.behavior = "url('#default#time2')" |
|---|
object.addBehavior ("#default#time2") |
Possible Values
t | Prefix required by the time2 behavior. This prefix is
set using the XMLNS attribute of the HTML |
| PredefinedTag | One of the following predefined tags:
| animation | Defines a timed animation element in an HTML document. | | audio | Defines a timed audio element in an HTML document. | | excl | Defines a time container that allows only one child element to play at any given time. | | img | Defines a timed image element in an HTML document. | | media | Defines a generic, timed media element in an HTML document. | | par | Defines a new timeline container in an HTML document for independently timed elements. | | ref | Defines a reference to a generic timed element in an HTML document. | | seq | Defines a new timeline container in an HTML document for sequentially timed elements. | | video | Defines a timed video element in an HTML document. |
|
| sID | String that specifies a unique identifier for the object. |
|
Members Table
The following table lists the members exposed by the
time2
object.
| Attribute | Property | Description |
|---|
| ACCELERATE | accelerate |
Sets or gets a value that applies an acceleration to an element timeline. |
| AUTOREVERSE | autoReverse |
Sets or gets whether the timeline on an element begins playing in reverse immediately after it completes in the forward direction. |
| BEGIN | begin |
Sets or gets the delay time before the timeline begins playing on the element. |
| DECELERATE | decelerate |
Sets or gets a value that applies a deceleration to the end of a simple duration. |
| DUR | dur |
Sets or gets a value indicating the amount of time the element remains active or displayed. |
| element |
Retrieves the dispatch for an animated element. |
| END | end |
Sets or gets a value indicating the end time for the element, or the end of the simple duration when the element is set to repeat. |
| FILL | fill |
Sets or gets the action taken by an element if the element timeline ends before the timeline on its parent element ends. |
| hasMedia |
Gets a Boolean value that indicates whether the element is an Introduction to HTML+TIME media element. |
| isDirectMusicInstalled |
Retrieves whether direct music is installed. |
| MUTE | mute |
Sets or gets a value that indicates whether the audio is turned on or off. |
| REPEATCOUNT | repeatCount |
Sets or gets the number of times an element timeline repeats. |
| REPEATDUR | repeatDur |
Sets or gets the number of seconds that an element timeline repeats. |
| RESTART | restart |
Sets or gets the conditions under which an element can be restarted on a timeline. |
| SPEED | speed |
Sets or gets the playback speed of an element relative to its parent time container. |
| SYNCBEHAVIOR | syncBehavior |
Sets or gets a value that indicates the synchronization rules for the element timeline. |
| SYNCMASTER | syncMaster |
Sets or gets whether the time container must synchronize playback to this element. |
| syncTolerance |
Sets or gets the time variance that is allowed on a timeline with locked synchronization. |
| systemBitrate | |
Gets the approximate bandwidth available to the system in bits-per-second. |
| systemCaptions | |
Indicates whether to display a text equivalent of the audio portion of the presentation. |
| systemLanguage | |
Indicates whether a given language is selected in a user's system preferences. |
| systemOverdubOrSubtitle | |
Specifies whether overdubs or subtitles render during a presentation.
|
| TIMEACTION | timeAction |
Sets or gets the action that is taken on the element while the timeline is active. |
| TIMECONTAINER | timeContainer |
Sets or gets the type of timeline associated with an element. |
| timeParent |
Gets the parent time container element of the current element. |
| VOLUME | volume |
Sets or gets the volume of the media file. |
Events
| Event | Description |
|---|
| onbegin |
Fires when the timeline starts on an element. |
| onend |
Fires when the timeline stops on an element. |
| onmediacomplete |
Fires when the element's associated media finish loading. |
| onmediaerror |
Fires when an element's media file causes any error. |
| onpause |
Fires when the timeline on an element pauses. |
| onrepeat |
Fires when the timeline repeats on an element, beginning with the second iteration. |
| onreset |
Fires when the timeline reaches the value of the BEGIN attribute or when the resetElement method is called on the element. |
| onresume |
Fires when an element's timeline resumes from a paused state. |
| onreverse |
Fires when the timeline on an element begins to play backward. |
| onseek |
Fires whenever a seek operation is performed on the element. |
Methods
| Method | Description |
|---|
| activeTimeToParentTime |
Converts a value in the element's active timeline to the corresponding point in the parent timeline. |
| activeTimeToSegmentTime |
Converts a value in the element's active timeline to the corresponding point in the segment timeline. |
| addFragment |
Adds a fragment to the composer site. Consults the registered composer factories to find the proper composer.
|
| beginElement |
Starts the element on the timeline. |
| beginElementAt |
Starts an element's timeline at the specified time. |
| buttonActivate |
Activates the currently-selected button. |
| detachFromComposer |
Notifies the fragment to detach itself from the animation composer. |
| documentTimeToParentTime |
Converts a value in the document timeline to the corresponding point in the element's parent timeline. |
| endElement |
Stops the element on the timeline. |
| endElementAt |
Ends an element's timeline at the specified time. |
| enumerateFragments |
Enumerates the fragments on the composer registered for the given attribute name. |
| get_value |
Retrieves an animated attribute's current value. |
| gotoMenu |
Navigates to menu. |
| insertFragment |
Inserts a fragment into the composer site at the specified index. |
| leftButtonSelect |
Selects the button to the left of the current button. |
| lowerButtonSelect |
Selects the button below the current button. |
| parentTimeToActiveTime |
Converts a value in the parent timeline to the corresponding point in the element's active timeline. |
| parentTimeToDocumentTime |
Converts a value in the element's parent timeline to the corresponding point in the document timeline. |
| pauseElement |
Stops playing an element's timeline at the current point. |
| registerComposerFactory |
Registers a new composer factory with this site. |
| removeFragment |
Removes a fragment from the composer site. |
| resetElement |
Removes any changes made to the element and returns the element to its original state. |
| resumeElement |
Restarts the element's timeline from a paused state. |
| rightButtonSelect |
Selects the button to the right of the current button. |
| seekActiveTime |
Locates a specified point on the element's active timeline and begins playing from that point. |
| seekSegmentTime |
Locates the specified point on the element's segment timeline, and begins playing from that point. |
| seekTo |
Locates a specified point on the element's segment timeline, including repetitions, and begins playing from that point. |
| seekToFrame |
Locates a specified frame in the object. |
| segmentTimeToActiveTime |
Converts a value in the element's segment timeline to the corresponding point in the element's active timeline. |
| segmentTimeToSimpleTime |
Converts a value in the element's segment timeline to the corresponding point in the element's simple timeline. |
| simpleTimeToSegmentTime |
Converts a value in the element's simple timeline to the corresponding point in the element's segment timeline. |
| unregisterComposerFactory |
Unregisters a composer factory on this site. |
| upperButtonSelect |
Selects the button above the current button. |
Objects
| Object | Description |
|---|
| currTimeState |
Contains information about an HTML+TIME timeline. |
Remarks
This behavior supersedes the time behavior.
This default behavior adds timing to HTML pages. Using the HTML+TIME (Timed Interactive Multimedia Extensions) extensions, any HTML element can be set to appear at a given time, last for a specified duration, and repeat the action if desired. In addition to hiding and displaying elements, inline CSS styles can be applied to elements for a specified duration. The time2 behavior supports all time-related attributes, properties, methods, and events.
HTML+TIME is not supported in HTML Component (HTC) files.
The members listed in the preceding table might not be accessible through scripting until the window.onload event fires. Waiting for this event to fire ensures that the page is completely loaded, that all behaviors have been applied to corresponding elements on the page, and that all the behavior's properties, methods, and events are available for scripting. Using any of the behavior-defined members before the window.onload event fires could result in a scripting error, indicating that the object does not support that particular member.
The time2 behavior is available as of Microsoft Internet Explorer 5.5 only in the Microsoft Win32 platform.
Note HTML+TIME 2.0 is available in minimal installations of Internet Explorer 5.5 and Internet Explorer 6.
Applies To
|
A,
ABBR,
ACRONYM,
ADDRESS,
AREA,
B,
BIG,
BLOCKQUOTE,
BUTTON,
CAPTION,
CENTER,
CITE,
CODE,
DD,
DEL,
DIR,
DIV,
DL,
DT,
EM,
FIELDSET,
FONT,
FORM,
hn,
HR,
I,
IFRAME,
IMG,
INPUT type=button,
INPUT type=checkbox,
INPUT type=file,
INPUT type=hidden,
INPUT type=image,
INPUT type=password,
INPUT type=radio,
INPUT type=reset,
INPUT type=submit,
INPUT type=text,
INS,
KBD,
LEGEND,
LI,
LISTING,
MARQUEE,
MENU,
OL,
OPTION,
P,
PLAINTEXT,
PRE,
Q,
S,
SAMP,
selection,
SMALL,
SPAN,
STRIKE,
STRONG,
SUB,
SUP,
TABLE,
TBODY,
TD,
TEXTAREA,
TFOOT,
TH,
THEAD,
TR,
TT,
U,
UL,
VAR,
XMP |
See Also
Introduction to HTML+TIME