t:PAR Element | par Behavior(deprecated)

HTML (DHTML)

t:PAR Element | par Behavior?deprecated)

Internet Development Index

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 new timeline container in an HTML document for independently timed elements.

Syntax

XML <t:PAR ID=sID STYLE="behavior:url('#default#time')" />
HTML N/A
Scripting N/A

Possible Values

sIDString that specifies a unique identifier for the object.

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

AttributePropertyDescription
t:ACCELERATEaccelerate Sets or retrieves a value that applies an acceleration to the element's local timeline.
t:AUTOREVERSEautoReverse Sets or retrieves whether the timeline on an element immediately begins playing in reverse after completing in the forward direction.
t:BEGINbegin Sets or retrieves the delay time before the timeline begins playing on the element.
t:BEGINAFTERbeginAfter Sets or retrieves a value indicating that the timeline of an element starts when the referenced element ends.
t:BEGINEVENTbeginEvent Sets or retrieves a value that starts the timeline of an element when the referenced event occurs.
t:BEGINWITHbeginWith Sets or retrieves a value that starts an element's timeline at the same time as the referenced element.
currTime Retrieves a value indicating the current time along the simple duration as defined by the element's t:DUR or t:END attribute.
t:DECELERATEdecelerate Sets or retrieves a value that applies a deceleration to the end of a simple duration.
t:DURdur Sets or retrieves a value indicating the amount of time the element remains active or displayed.
t:ENDend 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.
t:ENDEVENTendEvent Sets or retrieves 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:ENDHOLDendHold Sets or retrieves whether an element remains active if its timeline ends before the timeline on its parent element ends.
t:EVENTRESTARTeventRestart Sets or retrieves whether the element should restart if a beginEvent call occurs while the local timeline is already running.
localTime Retrieves a value indicating the current time along the local duration, as defined by the element's t:REPEAT or t:REPEATDUR attribute.
t:REPEATrepeat Sets or retrieves the number of times an element's timeline repeats.
t:REPEATDURrepeatDur Sets or retrieves the number of seconds an element's timeline repeats.
t:SYNCBEHAVIORsyncBehavior Sets or retrieves the synchronization rules for the element's timeline.
syncTolerance Retrieves the time variance allowed on a timeline with locked synchronization.
t:TIMEACTIONtimeAction Sets or retrieves what action is taken on the element while the timeline is active.

Events

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

Methods

MethodDescription
beginElement Starts the element on the timeline.
endElement Stops the element on the timeline.

Remarks

All HTML descendants of this element have independent, or parallel, timing.

Use this element instead of the t:TIMELINE 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 prefix t is 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:PAR element is available as of Microsoft?Internet Explorer 5, only in the Microsoft?Win32?platform.

Example

This example uses the t:PAR element to apply a timeline to a group of HTML elements.

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<XML:NAMESPACE PREFIX="t"/>
<STYLE>
.time    { behavior:url(#default#time);}
</STYLE>
</HEAD>
<BODY BGCOLOR="white">
<FONT FACE="Verdana">
<t:PAR CLASS=time t:BEGIN="0" t:DUR="10" t: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 t: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>
</FONT>
</BODY>
</HTML>
This feature requires Microsoft?Internet Explorer 5 or later. Click the following icon to install the latest version. Then reload this page to view the sample.

See Also

Introduction to DHTML Behaviors, Introduction to HTML+TIME, time, time2, Using DHTML Behaviors