t:MEDIA Element | media Behavior (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.
Defines a generic, timed media element in an HTML document.
Syntax
XML <t:MEDIA<code> ID=</code>sID<code> STYLE="<a href="https://msdn.microsoft.com/en-us/library/ms530723">behavior</a>:url('#default#time')"</code> /> </td>HTML N/A Scripting N/A Possible Values
sID String that specifies a unique identifier for the object. Members Table
The following table lists the members exposed by the media object.
Attribute Property Description t:ACCELERATE accelerate Sets or gets a value that applies an acceleration to the element's local timeline.
t:AUTOREVERSE autoReverse Sets or gets whether the timeline on an element immediately begins playing in reverse after completing in the forward direction.
t:BEGIN begin Sets or gets the delay time before the timeline begins playing on the element.
t:BEGINAFTER beginAfter Sets or gets a value indicating that the timeline of an element starts when the referenced element ends.
t:BEGINEVENT beginEvent Sets or gets a value that starts the timeline of an element when the referenced event occurs.
t:BEGINWITH beginWith Sets or gets a value that starts an element timeline at the same time as the referenced element.
t:CLIPBEGIN clipBegin Sets or gets the beginning point of a sub-clip of a continuous media object.
t:CLIPEND clipEnd Sets or gets the end point of a sub-clip of a continuous media object.
t:CLOCKSOURCE clockSource Sets or gets whether all the elements within the local time scope are synchronized with the timeline on this element.
currTime Gets a value indicating the current time on the simple duration as defined by the element's t:DUR attribute or the t:END attribute.
t:DECELERATE decelerate Sets or gets a value that applies a deceleration to the end of a simple duration.
t:DUR dur Sets or gets a value indicating the amount of time the element remains active or displayed.
t: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.
t:ENDEVENT endEvent Sets or gets a value indicating that the timeline of an element ends immediately when the referenced event occurs, regardless of the element's repeat count or repeatDur property.
t:ENDHOLD endHold Sets or gets whether an element remains active if its timeline ends before the timeline on its parent element ends.
t:EVENTRESTART eventRestart Sets or gets whether the element should restart if a beginEvent call occurs while the local timeline is already running.
t:IMG img Sets or gets the URL of an alternate image to display if the MIME type is not supported on the user's computer.
localTime Gets a value indicating the current time along the local duration, as defined by the element's t:REPEAT atribute or t:REPEATDUR attribute.
t:PLAYER player Sets or gets the object used to render the media associated with this element.
playerObject Gets the object that plays media files.
t:REPEAT repeat Sets or gets the number of times an element timeline repeats.
t:REPEATDUR repeatDur Sets or gets the number of seconds an element timeline repeats.
t:SRC src Sets or gets the source URL of the media.
t:SYNCBEHAVIOR syncBehavior Sets or gets the synchronization rules for the element timeline.
syncTolerance Gets the time variance allowed on a timeline with locked synchronization.
t:TIMEACTION timeAction Sets or gets the action that is taken on the element while the timeline is active.
t:TYPE type Sets or gets the MIME type of the media object referenced by the t:SRC attribute.
Event Property 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 is finished loading.
onmedialoadfailed Fires when an element's media file fails to load for any reason.
onmediaslip Fires when an element's media file fails to keep up with the defined timeline.
onpause Fires when the timeline on an element pauses.
onrepeat Fires when the timeline repeats on an element, beginning with the second iteration.
onresume Fires when an element's timeline resumes from a paused state.
onresync Fires when the element's associated media synchronization is interrupted.
onreverse Fires when the timeline on an element begins to play backward.
onscriptcommand Fires when the Microsoft Windows Media Player control receives a synchronized command or URL.
Method Description beginElement Starts the element on the timeline.
endElement Stops the element on the timeline.
Remarks
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.
Although different media-based elements exist, there is no functional difference in their current implementation. However, you are encouraged to use elements such as t:AUDIO, t:IMG, t:MEDIA, and t:VIDEO for improved document readability and enhanced support.
The prefix
tis used to associate this element with an XML namespace. You must include the following line of code in the head section of your HTML document when using this element.<XML:NAMESPACE PREFIX="t"/>The t:MEDIA element is available as of Microsoft Internet Explorer 5, only in the Microsoft Win32 platform.
See Also
Introduction to DHTML Behaviors, Introduction to HTML+TIME, time, time2, Using DHTML Behaviors