SELFHTML: JavaScript / Référence objet / embeds

SELFHTML/Aides à la navigation

JavaScript/DOM

Référence objet

embeds

embeds: généralités sur l'utilisation

Propriétés:

height (hauteur de l'objet intégré)
hspace (espace horizontal de l'objet intégré)
length (nombre d'objets intégrés)
name (Nom de l'objet intégré)
src (source de l'objet intégré)
width (largeur de l'objet intégré)
type (type Mime de l'objet intégré)
vspace (espace vertical de l'objet intégré)

Méthodes:

play()
stop()

embeds: généralités sur l'utilisation

Avec l'objet embeds, qui est situé sous l'objet document dans la hiérarchie objet JavaScript, vous avez accès à tous les éléments multimédia qui sont définis dans le fichier HTML avec l'élément Netscape <embed>...</embed>. Ainsi vous pouvez par exemple lancer la diffusion de fichiers son et de vidéos de façon dynamique.

Un nouvel objet de ce genre est créé automatiquement lorsque le navigateur Web rencontre une référence multimédia (Netscape traditionnel) dans le fichier HTML.

Les manières suivantes sont à votre disposition pour adresser une référence multimédia déterminée avec JavaScript:

Schéma 1 / exemple 1:

document.embeds[#].propri�t�
document.embeds[#].m�thode()

Breite = document.embeds[0].width;

Schéma 2 / exemple 2:

document.embeds.["nom_objet"].propri�t�
document.["nom_objet"].m�thode()

largeur = document.embeds["video_demo"].width;

Explication:

Vous pouvez adresser ce genre d'objets de deux façons:

avec un numéro d'index (comme dans le schéma 1 /exemple 1)
Pour l'utilisation de numéros d'index, mentionnez document.embeds suivi, entre crochets, du numéro d'ordre de l'élément embed que vous voulez adresser dans le fichier. Chaque objet, qui a été noté avec <embed> dans le fichier HTML, compte. Pensez que le compteur commence à 0, c'est à dire qu'il vous faut adresser la première référence multimédia avec embeds[0], la deuxième avec embeds[1] etc... Pour compter, prévaut l'ordre dans lequel les commandes <embed> sont notées dans le fichier.
avec le nom de la référence (comme dans le schéma 2 /exemple 2)
Pour cela, mentionnez avec document.embeds["nom_objet"] le nom que vous avez mentionné pour le définition de la référence Multimedia dans le repère d'ouverture <embed> dans l'attribut name=.

Attention:

Que vous puissiez effectivement adresser une référence multimédia avec JavaScript par l'objet embeds, dépend, tout au moins chez Netscape de la façon dont le plugiciel est conçu. Le plugiciel, donc le programme additif ou module de programme qui assure dans le navigateur, la diffusion par exemple d'une vidéo ou d'un fichier son, doit disposer d'une interface Java. Sinon, vous recevez chez Netscape des messages d'erreur JavaScript du genre Java object has no field or method named ....

height

Sauvegarde la hauteur de l'objet multimédia intégré.

Exemple:

Exemple d'affichage: aperçu

<html><head><title>Test</title></head>
<body onLoad="alert('hauteur de l\'objet: ' + document.embeds[0].height + ' pixels')">
<embed src="breeze.mid" width="300" height="200"></embed><br>
</body></html>

Explication:

L'exemple contient une référence multimédia d'un fichier Midi. Après que le fichier HTML est chargé complètement, est sortie dans une fenêtre de dialogue avec alert() la hauteur de l'objet référencé. Pour cela, le gestionnaire d'événement onLoad est noté dans le repère d'ouverture <body>.

hspace

Sauvegarde la mention de l'espace horizontal, telle qu'elle est possible avec la mention hspace= dans le repère d'ouverture <embed>, séparant une référence multimédia des éléments qui la jouxtent.

Exemple:

Exemple d'affichage: aperçu

<html><head><title>Test</title></head><body>
<embed src="yippee.wav" width="200" height="100" hspace="30" align="left"></embed><br>
<a href="javascript:alert(document.embeds[0].hspace)">afficher hspace!</a>
</body></html>

Explication:

L'exemple contient une référence multimédia et un lien. En cliquant sur ce lien, la valeur qui est sauvegardée dans la mention hspace= est sortie avec alert().

length

Sauvegarde le nombre des objets incorporés dans le document.

Exemple:

Exemple d'affichage: aperçu

<html><head><title>Test</title></head>
<body onLoad="alert(document.embeds.length)">
<embed src="breeze.mid" width="300" height="200" type="audio/x-midi"></embed>
</body></html>

Explication:

L'exemple contient une référence multimédia . Après que le fichier HTML est chargé complètement, est sorti dans une fenêtre de dialogue avec alert() le nombre d'objets référencés. Pour cela, le gestionnaire d'événement onLoad est noté dans le repère d'ouverture body.

name

Sauvegarde le nom d'un objet incorporé tel qu'il a été attribué avec la mention name= dans le repère d'ouverture <embed>. Si la mention manque dans le repère HTML, la propriété d'objet name ne contient aucune valeur.

Exemple:

Exemple d'affichage: aperçu

<html><head><title>Test</title></head>
<body>
<embed autostart="false" name="Musique" src="breeze.mid" width="300" height="200"></embed>
<a href="javascript:document.embeds['Musique'].play()">mise en route</a>
</body></html>

Explication:

L'exemple contient une référence multimédia et un lien. En cliquant sur ce lien, l'élément multimédia est adressé avec document.embeds['Musique'] et par l'emploi de la méthode play() la diffusion est mise en route.

src

Source de données de l'objet multimédia.

Exemple:

Exemple d'affichage: aperçu

<html><head><title>Test</title></head>
<body>
<embed src="breeze.mid" autostart="true" name="Musique" width="300" height="200"></embed> <br>
<script type="text/javascript">
<!--
  document.write("Download".link(document.embeds["Musique"].src));
//-->
</script>
</body></html>

Explication:

Dans l'exemple est définie une référence multimédia . Dans le passage JavaScript qui suit, un lien est écrit dans le document avec la méthode link(). Le fichier source de la référence multimédia est ici transmis à la méthode comme cible du lien par la lecture de la propriété src avec document.embeds["Musique"].src.

width

Sauvegarde la largeur de l'objet multimédia incorporé.

Exemple:

Exemple d'affichage: aperçu

<html><head><title>Test</title></head>
<body onLoad="alert('largeur d\'objet: ' + document.embeds[0].width + ' pixels')">
<embed src="breeze.mid" width="300" height="200"></embed><br>
</body></html>

Explication:

L'exemple contient la référence multimédia d'un fichier Midi. Après que le fichier HTML est chargé complètement, est sortie dans une fenêtre de dialogue avec alert() la largeur de l'objet référencé. Pour cela, le gestionnaire d'événement onLoad est noté dans le repère d'ouverture <body>.

type

Donne le type Mime de la référence multimédia, telle qu'elle a été définie dans l'attribut type=. Si cette propriété n'a pas été définie, alors la propriété contient null voire undefinied dans l'Explorer Internet MS.

Exemple:

Exemple d'affichage: aperçu

<html><head><title>Test</title></head>
<body onLoad="alert('Type Mime de l'objet: ' + document.embeds[0].type)">
<embed src="breeze.mid" width="300" height="200" type="audio/x-midi"></embed><br>
</body></html>

Explication:

L'exemple contient une référence multimédia d'un fichier Midi. Après que le fichier HTML est chargé complètement, est sortie dans une fenêtre de dialogue avec alert() le type de l'objet référencé. Pour cela, le gestionnaire d'événement onLoad est noté dans le repère d'ouverture <body>.

vspace

Sauvegarde la mention de l'espace vertical, telle qu'elle est possible avec la mention vspace= dans le repère d'ouverture <embed>, séparant une référence multimédia des éléments qui la jouxtent en haut et en bas.

Exemple:

Exemple d'affichage: aperçu

<html><head><title>Test</title></head><body>
Un �l�ment multim�dia<br>
<embed type="audio/x-wav" src="yippee.wav" width="200" height="100" vspace="30" align="left"></embed><br>
<a href="javascript:alert(document.embeds[0].vspace)">afficher l'espace vertical!</a>
</body></html>

Explication:

L'exemple contient une référence multimédia et un lien. En cliquant sur ce lien, la valeur qui est sauvegardée dans la mention vspace= est sortie avec alert()

play()

Met en route la diffusion d'une référence multimédia. La commande adresse une interface de l'appareil de reproduction. Sa façon d'agir est, pour cette raison, toujours dépendante du plugiciel utilisé et n'est pas disponible dans tous les cas.

Exemple:

Exemple d'affichage: aperçu

<html><head><title>Test</title></head>
<body>
<embed type="audio/x-midi" autostart="false" src="breeze.mid" width="300" height="200"></embed><br>
<a href="javascript:document.embeds[0].play()">mise en route</a>
</body></html>

Explication:

L'exemple contient une référence multimédia et un lien. . En cliquant sur ce lien, l'élément multimédia est adressé avec document.embeds[0].play() et la diffusion est mise en route.

stop()

Met un terme à la diffusion d'une référence multimédia. La commande adresse une interface de l'appareil de reproduction. Sa façon d'agir est, pour cette raison, toujours dépendante du plugiciel utilisé et n'est pas disponible dans tous les cas.>

Exemple:

Exemple d'affichage: aperçu

<html><head><title>Test</title></head>
<body>
<embed type="audio/x-midi" autostart="true" src="breeze.mid" width="300" height="200"></embed><br>
<a href="javascript:document.embeds[0].stop()">arr�ter</a>
</body></html>

Explication:

L'exemple contient une référence multimédia et un lien. . En cliquant sur ce lien, l'élément multimédia est adressé avec document.embeds[0].stop() et la diffusion est arrêtée.


	layers
	images

SELFHTML/Aides à la navigation

JavaScript/DOM

Référence objet