LOOP Attribute | loop Property

Sets or retrieves the number of times a sound or video clip will loop when activated.

Syntax

HTML	<ELEMENT LOOP = iLoop... >
Scripting	object.loop [ = iLoop ]

Possible Values

iLoop

Variant that specifies or receives one of the following values. -1 Loops infinitely. 0 Loops one time. count Number of times to loop.

The property is read/write. The property has a default value of 1.

Expressions can be used in place of the preceding value(s), as of Microsoft® Internet Explorer 5. .

Remarks

To restart a sound or video clip after changing its loop property, set the src property or dynsrc property to itself. For example:

oBGSound.src = oBGSound.src

In Microsoft Internet Explorer 4.0, when you restart a video by changing its loop property, the video opens and plays in a new window.

The following are descriptions of how the loop property works for some boundary cases.

<BGSOUND src="file:///c:\win95\system\msremind.wav">	Loops one time
<BGSOUND src="file:///c:\win95\system\msremind.wav" LOOP>	Loops one time.
<BGSOUND src="file:///c:\win95\system\msremind.wav" LOOP=>	Loops one time.
<BGSOUND src="file:///c:\win95\system\msremind.wav" LOOP=0>	Loops one time.
<BGSOUND src="file:///c:\win95\system\msremind.wav" LOOP=-1>	Loops infinitely.

Example

This example uses the loop property and the src property to change the number of times a background sound loops.

<SCRIPT>
function loopOnce() {
    oBGSound.loop = 1;
    oBGSound.src = oBGSound.src; // reload sound
}
function loopContinuously() {
    oBGSound.loop = -1;
    oBGSound.src = oBGSound.src; // reload sound
}
</SCRIPT>
:
<BGSOUND id="oBGSound" src="sound.wav">
<BUTTON onclick="loopOnce()">Loop Sound Once</BUTTON> 
<BUTTON onclick="loopContinuously()">Loop Sound Continuously</BUTTON>

Standards Information

There is no public standard that applies to this property.

Applies To

	BGSOUND, IMG, INPUT, INPUT type=image