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é) Méthodes: |
|
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:
document.embeds[#].propriété document.embeds[#].méthode() Breite = document.embeds[0].width; |
document.embeds.["nom_objet"].propriété document.["nom_objet"].méthode() largeur = document.embeds["video_demo"].width; |
Vous pouvez adresser ce genre d'objets de deux façons:
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.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=
.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 ....
Sauvegarde la hauteur de l'objet multimédia intégré.
<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> |
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>
.
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.
<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> |
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().
Sauvegarde le nombre des objets incorporés dans le document.
<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> |
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
.
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.
<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> |
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.
Source de données de l'objet multimédia.
<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> |
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
.
Sauvegarde la largeur de l'objet multimédia incorporé.
<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> |
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>
.
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.
<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> |
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>
.
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.
<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> |
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()
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.
<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> |
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.
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.>
<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> |
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 |
© 2001 Stefan Münz / © 2003 Traduction Serge François, 13405@free.fr
selfhtml@fr.selfhtml.org