SYNCBEHAVIOR Attribute | syncBehavior Property

  • Article

This topic documents a feature of HTML+TIME 2.0, which is obsolete as of Windows Internet Explorer 9.

Sets or gets a value that indicates the synchronization rules for the element timeline.

Syntax

HTML <ELEMENT SYNCBEHAVIOR = sRule... >
Scripting [ sRule = ] object.syncBehavior

Possible Values

sRule String that specifies or receives one of the following values.
canSlip
Element does not have to be synchronized with the parent element timeline. This allows enough flexibility for an HTML page to handle network problems.
locked
Element must be synchronized with the parent element timeline. For example, a parent element timeline does not progress until the child element media is ready to be played.

The property is read/write. The property has no default value.

Remarks

You must use this property with the SYNCMASTER attribute to determine which elements to synchronize in the document. If a media file isn't ready when the timeline begins, the canSlip value allows the parent timeline to continue without interruption. The timeline on the element associated with the media begins as soon as the file loads.

If you set an element's SYNCBEHAVIOR attribute to locked, the parent timeline must pause and wait for the element to catch up. If the parent element timeline is also locked, the scope of the synchronization behavior is extended to include all of the timed children for the parent's parent element. If all timelines are locked, the entire document pauses when an element cannot maintain its synchronization.

The SYNCBEHAVIOR attribute applies to the media delivery of an element, or to the sync relationship of the timeline defined by a time container. If there is a delay or interruption in either the media element or the time container, the SYNCBEHAVIOR attribute controls how the media element is delivered while the rest of the document continues to play.

Example

This example uses the syncBehavior property to show how to set the synchronization rules of a timeline.

...
<DIV style="position:absolute;left:300">
    ...
    <t:PAR id="par2" timeAction="display" >
        <t:media id="oMedia1" begin="0s" dur="20s" timeAction="display"
            syncMaster="true" syncBehavior="locked"
            src="\workshop\samples\author\behaviors\media\shuttle3.avi"  />
    </t:PAR>
</DIV>
...

Code example: http://samples.msdn.microsoft.com/workshop/samples/author/behaviors/syncbehavior.htm

Applies To

t:ANIMATION, t:AUDIO, t:EXCL, t:IMG, t:MEDIA, t:PAR, t:REF, t:SEQ, time2, t:VIDEO

See Also

Introduction to HTML+TIME, syncTolerance