SYNCBEHAVIOR Attribute | syncBehavior Property (t:ANIMATION, t:AUDIO, t:EXCL, ...)

HTML (DHTML)

SYNCBEHAVIOR Attribute | syncBehavior Property

Internet Development Index

Sets or retrieves a value that indicates the synchronization rules for the element's timeline.

Syntax

HTML<ELEMENT SYNCBEHAVIOR = sRule... >
Scriptingobject.syncBehavior [ = sRule ]

Possible Values

sRuleString that specifies or receives one of the following values:
canSlipElement does not have to be synchronized with the parent element's timeline. This allows an HTML page enough flexibility to handle network problems.
lockedElement must be synchronized with the parent element's timeline. For example, a parent element's timeline does not progress until the child element's 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 within the document. If a media file isn't ready when the timeline begins, the canSlip value enables 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's timeline is also locked, the scope of the synchronization behavior is extended to include all of the timed children of the parent's own 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>
...
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 property is defined in Synchronized Multimedia Integration Language (SMIL) 2.0 Non-Microsoft link.

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