RESTART Attribute | restart Property

Sets or retrieves the conditions under which an element can be restarted on a timeline.

Syntax

HTML <ELEMENT RESTART = sAction... >
Scripting object.restart(action) [ = sAction ]

Possible Values

sAction String that specifies or receives one of the following values.
always Default. Element can be restarted at any time.
never Element cannot be restarted for the remaining duration of the parent time container.
whenNotActive Element can be restarted only when it is not active on the timeline.
The property is read/write. The property has a default value of always.

Remarks

This property supersedes the eventRestart property.

Example

This example demonstrates each of the three values (always, never, whenNotActive) for the restart property. These values specify the conditions in which an element can be restarted on a timeline.

<HTML XMLNS:t="urn:schemas-microsoft-com:time">
<HEAD>
<?IMPORT namespace="t" implementation="#default#time2">
<STYLE>
.time{ behavior: url(#default#time2);}
</STYLE>
</HEAD>
<BODY>
<t:par id="tp1" begin="indefinite" dur="20">
<DIV id="div1" class="time"
style="position:absolute;top:255px;left:35px;width:100px;height:100px;
background-color:yellow; font-size:large; text-align:center;"
end="6" restart="never">DIV1<BR>'never'
</DIV>
<DIV id="div2" class="time"
style="position:absolute;top:255px;left:145px;width:100px;height:100px;
background-color:blue; font-size:large; text-align:center;"
begin="2" end="8" restart="always">DIV2<BR>'always'
</DIV>
<DIV id="div3" class="time"
style="position:absolute;top:255px;left:255px;width:100px;height:100px;
background-color:green; font-size:large; text-align:center;"
begin="4" end="10" restart="whenNotActive">DIV3<BR>'whenNotActive'
</DIV>
</t:par>
<P style="position:absolute; top:370px; left:45px;">
<BUTTON id="b0" onclick="tp1.beginElement();"
style="font-weight:bold;">Start</BUTTON>
<BUTTON id="b1" onclick="tp1.endElement();">Stop</BUTTON>&nbsp;&nbsp;
<BUTTON id="b2" onclick="div1.beginElement();alert('DIV1 cannot be restarted for the remaining duration of the parent time container (20 seconds).');">Restart DIV1</BUTTON>
<BUTTON id="b3" onclick="div2.beginElement();">Restart DIV2</BUTTON>
<BUTTON id="b4" onclick="div3.beginElement();">Restart DIV3</BUTTON>
</P>
</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 property is defined in Synchronized Multimedia Integration Language (SMIL) 2.0 .

Applies To

t:TRANSITIONFILTER, t:ANIMATE, t:ANIMATECOLOR, t:ANIMATEMOTION, t:ANIMATION, t:AUDIO, t:IMG, t:MEDIA, t:PAR, t:REF, t:SEQ, t:SET, time2, t:VIDEO