bgsound

NN s.o. IE 4 DOM s.o.

Un élément bgsound définit un fichier son joué en arrière-plan lorsque l'utilisateur visite une page. Définissez des propriétés pour contrôler le volume et le nombre de fois que la plage son est jouée, même après le chargement du fichier son. Certaines propriétés, comme innerHTML et innerText, sont présentées dans la version Windows, mais elles ne sont pas applicables aux éléments dépourvus de balise de fermeture.

Equivalent HTML

<bgsound>

Référence de modèle d'objet

[window.]document.getElementById("elementID")

Propriétés spécifiques à l´objet

balance

loop

src

volume

Méthodes spécifiques à l´objet

Aucune.

Propriétés de gestionnaire d´événements spécifiques à l´objet

Aucune.

balance	NN s.o. IE 4 DOM s.o.
	Lecture seule
Spécifie le mode de répartition du son entre les haut-parleurs gauche et droit. Une fois cette valeur définie dans l'élément, il n'est plus possible de la modifier à l'aide d'un script.

Exemple

var currBal = document.getElementsByTagName("bgsound")[0].balance;

Valeur
Nombre entier négatif ou positif compris entre -10 000 et +10 000. La valeur 0 correspond au niveau de balance moyen (répartition égale du son entre les deux enceintes). Une valeur négative indique que le haut-parleur gauche est dominant, et une valeur positive que le haut-parleur droit est dominant.

Par défaut
0

loop	NN s.o. IE 4 DOM s.o.
	Lecture/écriture
Indique combien de fois le son doit être joué. La valeur -1 signifie que le son sera joué sans interruption jusqu'au déchargement de la page.

Exemple

document.getElementById("mySound").loop = 3;

Valeur
Nombre entier.

Par défaut
1

src	NN s.o. IE 4 DOM s.o.
	Lecture/écriture
Fournit l´adresse URL du fichier son à jouer. Modifie les mélodies jouées en affectant une nouvelle adresse URL à la propriété. La nouvelle mélodie est jouée selon le paramètre de la propriété loop.

Exemple

document.getElementById("tunes").src = "sounds/blues.aif";

Valeur
Adresse URL complète ou relative, sous forme de chaîne.

Par défaut
Aucune.

volume	NN s.o. IE 4 DOM s.o.
	Lecture/écriture
Spécifie le niveau sonore du son d'arrière-plan par rapport au niveau de sortie sonore maximum défini dans les préférences de l'utilisateur sur l'ordinateur client. Le volume maximum (paramètre zéro) ne peut pas dépasser le volume défini par l'utilisateur dans la zone Sons du Panneau de configuration. Les réglages de l'attribut peuvent atteindre des valeurs négatives allant jusqu'à –10.000 (bien que cette valeur soit nettement inférieure au seuil audible pour la plupart des utilisateurs).

Exemple

var currVolume = document.getElementById("themeSong").volume;

Valeur
Nombre entier.

Par défaut
Varie en fonction du système d'exploitation et des paramètres du son.