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

Integer that specifies one of the following values: 0, -1 Loops infinitely. count Number of times to loop.

The property is read/write with 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 Dynamic Properties.

Remarks

To restart a sound or video clip after changing its loop property, set the src property or dynsrc property, respectively, to itself (see Example). In 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 Internet Explorer 4.0 or later. Click the icon below to install the latest version. Then reload this page to view the sample.

Applies To

[ Object Name ] Platform Version Win16: Win32: Mac: Unix: WinCE: Version data is listed when the mouse hovers over a link, or the link has focus.	BGSOUND, IMG