Defines a new timeline container in an HTML document for sequentially timed elements.
Members Table
The following table lists the members exposed by the
seq
object. Click a tab on the left to choose the type of member you want to view.
Attributes/Properties
Attribute | Property | Description |
---|
ACCELERATE | accelerate |
Sets or retrieves a value that applies an acceleration to an element's timeline. |
AUTOREVERSE | autoReverse |
Sets or retrieves whether the timeline on an element begins playing in reverse immediately after completing in the forward direction. |
BEGIN | begin |
Sets or retrieves the delay time before the timeline begins playing on the element. |
DECELERATE | decelerate |
Sets or retrieves a value that applies a deceleration to the end of a simple duration. |
DUR | dur |
Sets or retrieves a value indicating the amount of time the element remains active or displayed. |
END | end |
Sets or retrieves 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 retrieves the action an element takes if its timeline ends before the timeline on its parent element ends. |
| hasMedia |
Retrieves a Boolean value that indicates whether the element is an Introduction to HTML+TIME media element. |
| mediaDur |
Retrieves the duration of the element's media file. |
| mediaHeight |
Retrieves the height of the element. |
| mediaWidth |
Retrieves the width of the element. |
MUTE | mute |
Sets or retrieves a value that indicates whether the audio is turned on or off. |
REPEATCOUNT | repeatCount |
Sets or retrieves the number of times an element's timeline repeats. |
REPEATDUR | repeatDur |
Sets or retrieves the number of seconds that an element's timeline repeats. |
RESTART | restart |
Sets or retrieves the conditions under which an element can be restarted on a timeline. |
SPEED | speed |
Sets or retrieves the playback speed of an element relative to its parent time container. |
SYNCBEHAVIOR | syncBehavior |
Sets or retrieves a value that indicates the synchronization rules for the element's timeline. |
| syncTolerance |
Sets or retrieves the time variance allowed on a timeline with locked synchronization. |
systemBitrate | |
Retrieves the approximate bandwidth available to the system in bits-per-second. |
systemCaptions | |
Indicates whether or not 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 retrieves what action is taken on the element while the timeline is active. |
TIMECONTAINER | timeContainer |
Sets or retrieves the type of timeline associated with an element. |
| timeParent |
Retrieves the parent time container element of the current element. |
VOLUME | volume |
Sets or retrieves the volume of the media file. |
Collections
Collection | Description |
---|
activeElements |
Returns a reference to the collection of all top-level child elements of the object that are currently active on the timeline. |
timeAll |
Retrieves a reference to the collection of all timed elements. |
timeChildren |
Retrieves a reference to the collection of all timed, top-level children elements. |
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. |
onoutofsync |
Fires when the element loses synchronization with its associated timeline. |
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. |
onsyncrestored |
Fires when synchronization is resumed between the element and its associated timeline. |
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. |
beginElement |
Starts the element on the timeline. |
beginElementAt |
Starts an element's timeline at the specified time. |
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. |
nextElement |
Advances the timeline so that the next element in the sequence begins playing. |
nextTrack |
Advances the media-playing container to the next track, or playItem object, in the playList collection, and begins playing that track. |
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. |
prevElement |
Resets the timeline so that the previous element in the sequence begins playing. |
prevTrack |
Sets the media-playing container to the previous track, or playItem object, in the playList collection and begins playing that track. |
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. |
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. |
Objects
Object | Description |
---|
currTimeState |
Contains information about an HTML+TIME timeline. |
Remarks
All timed HTML descendants of this Extensible Markup Language (XML) element have sequential timing. A duration value (dur property) must be specified or the next element in the sequence might never be displayed. Elements without timing attributes are ignored by the timing mechanism and are statically rendered. A timed element is an HTML element with an associated time behavior.
The default value of begin for children of a seq time container is 0 seconds.
The prefix t: is used to associate this element with an XML namespace. You must declare the XML namespace in the html tag of your document when using this element.
<HTML XMLNS:t ="urn:schemas-microsoft-com:time">
You must then import the tag definitions from the time2 behavior by using the IMPORT processing instruction.
<?IMPORT namespace="t" implementation="#default#time2">
The members listed in the following 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.
This element is not rendered.
This element requires a closing tag.
Example
This example uses the t:SEQ element to display a sequence of text lines without specifying begin times for each timed element in the sequence.
<HTML XMLNS:t ="urn:schemas-microsoft-com:time">
<HEAD>
<TITLE>SEQ</TITLE>
<STYLE>
.time {behavior:url(#default#time2);}
</STYLE>
<?IMPORT namespace="t" implementation="#default#time2">
</HEAD>
<BODY TOPMARGIN=0 LEFTMARGIN=0 BGPROPERTIES="FIXED" BGCOLOR="#FFFFFF"
LINK="#000000" VLINK="#808080" ALINK="#000000">
<t:SEQ ID="parent" BEGIN="0" DUR="indefinite">
<DIV ID="div1" CLASS="time" DUR="2">First line of text.</DIV>
<DIV ID="div1" CLASS="time" DUR="2">Second line of text.</DIV>
<DIV ID="div1" CLASS="time" DUR="2">Third line of text.</DIV>
<DIV ID="div1" CLASS="time" DUR="2">Fourth line of text.</DIV>
<SPAN STYLE="color:black" ID="span1" CLASS="time" DUR="indefinite">
<B>End of sequence.</B></SPAN>
</t:SEQ>
</BODY>
</HTML>
This feature requires Microsoft?Internet Explorer 5.5 or later.
Standards Information
This object is defined in
Synchronized Multimedia Integration Language (SMIL) 2.0
.
See Also
Introduction to HTML+TIME, par, time2, timeContainer