Microsoft Developer Network

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

Syntax

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

Possible Values

iLoop

Integer 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. For more information, see About Dynamic Properties.

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 >Loop Sound Once</BUTTON> 
<BUTTON >Loop Sound Continuously</BUTTON>

This feature requires Microsoft® Internet Explorer 4.0 or later. Click the following icon to install the latest version. Then reload this page to view the sample.

Standards Information

There is no public standard that applies to this property.

Applies To

BGSOUND, IMG, INPUT, INPUT type=image