LOOP Attribute | loop Property

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

Syntax

HTML Scripting

< ELEMENT LOOP = iLoop ... >

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>

Standards Information

There is no public standard that applies to this property.

Applies To

[ Object Name ] Platform Version

Win16:
Win32:
Windows CE:
Unix:
Mac:

BGSOUND , IMG , INPUT , INPUT type=image

Home | Top | Free Ajax Editor | JavaScript Editor

Get Advanced
JavaScript and Ajax Editor,
Validator and Debugger!
1st JavaScript Editor.

→

<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.