t:PAR Element | par Object

HTML (DHTML)

t:PAR Element | par Object

Defines a new timeline container in an HTML document for independently timed elements.

Members Table

The following table lists the members exposed by the par 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.
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.
ENDSYNC endSync Sets or retrieves the synchronization rule that specifies which child element is used to determine when the time container will end.
FILL fill Sets or retrieves the action an element takes if its timeline ends before the timeline on its parent element ends.
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.
TIMEACTION timeAction Sets or retrieves what action is taken on the element while the timeline is active.
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.
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.
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.

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.
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.
ENDSYNC	endSync	Sets or retrieves the synchronization rule that specifies which child element is used to determine when the time container will end.
FILL	fill	Sets or retrieves the action an element takes if its timeline ends before the timeline on its parent element ends.
	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.
TIMEACTION	timeAction	Sets or retrieves what action is taken on the element while the timeline is active.
	timeParent	Retrieves the parent time container element of the current element.
VOLUME	volume	Sets or retrieves the volume of the media file.

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.

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.

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.
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.
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.

Object	Description
currTimeState	Contains information about an HTML+TIME timeline.

Remarks

All HTML descendants of this element either have independent or parallel timing.
Use this element instead of the TIMECONTAINER attribute to create a time container without using an HTML element. All descendant elements, or time children, of this new time container inherit the time properties of their container. Unlike the time children of the t:SEQ element, the par descendants have no implicit timing relationships with each other, and their timelines might overlap. The t:PAR element effectively groups elements together so they can be easily modified as a single unit.
The default value of begin for children of a par time container is 0 seconds.
The prefix t: is used to associate this element with an Extensible Markup Language (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:PAR element to apply a timeline to a group of HTML elements.

<HTML XMLNS:t ="urn:schemas-microsoft-com:time">
<HEAD>
<TITLE>PAR</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:PAR BEGIN="0" DUR="10" TIMEACTION="display">
<H3>Paragraph 1</H3>
<P>This is paragraph number one. It appears for ten seconds immediately
after the page is loaded.</P>
<SPAN CLASS="time" BEGIN="5">
<H3>Paragraph 2</H3>
<P>This is paragraph number two. It appears five seconds after the
page is loaded, and remains displayed until its parent element's
timeline ends at ten seconds.</P>
</SPAN>
</t:PAR>
</BODY>
</HTML>

This feature requires Microsoft?Internet Explorer 5.5 or later. Click the following icon to install the latest version. Then reload this page to view the sample.

Standards Information

This object is defined in Synchronized Multimedia Integration Language (SMIL) 2.0 .