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. 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 onclick="loopOnce()">Loop Sound Once</BUTTON>
<BUTTON onclick="loopContinuously()">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