SELFHTML/Navigationshilfen JavaScript/DOM Objektreferenz | |
embeds |
|
embeds: Allgemeines zur Verwendung Eigenschaften:
height (Höhe des eingebetteten Objekts) Methoden: |
|
Mit dem Objekt embeds
, das in der JavaScript-Objekthierarchie unterhalb des document-Objekts liegt, haben Sie Zugriff auf alle Multimedia-Elemente, die in einer HTML-Datei mit dem Netscape-Element <embed>...</embed>
definiert sind. Dabei können Sie z.B. den Abspielvorgang von Sound-Dateien oder Videos dynamisch starten.
Ein neues Objekt dieser Art wird automatisch erzeugt, wenn der Web-Browser eine Multimedia-Referenz nach Netscape-Syntax in der HTML-Datei vorfindet.
Es stehen folgende Arten zur Verfügung, mit JavaScript eine bestimmte Multimedia-Referenz anzusprechen:
document.embeds[#].Eigenschaft document.embeds[#].Methode() Breite = document.embeds[0].width;
document.embeds["Objektname"].Eigenschaft document.embeds["Objektname"].Methode() Breite = document.embeds["Demovideo"].width;
Solche Objekte können Sie auf zwei Arten ansprechen:
document.embeds
an und dahinter in eckigen Klammern, das wie vielte embed
-Element in der Datei Sie meinen. Jedes Objekt, das in HTML mit dem <embed>
-Tag notiert wurde, zählt. Beachten Sie, dass der Zähler bei 0 beginnt, d.h. die erste Multimedia-Referenz sprechen Sie mit embeds[0]
an, die zweite mit embeds[1]
usw. Beim Zählen gilt die Reihenfolge, in der die <embed>
-Tags in der Datei notiert sind.document.embeds["Objektname"]
den Namen an, den Sie bei der Definition der Multimedia-Referenz im einleitenden <embed>
-Tag im Attribut name
angegeben haben.Ob Sie über das embeds
-Objekt eine Multimedia-Referenz tatsächlich mit JavaScript ansprechen können, hängt zumindest bei Netscape davon ab, wie das Plugin beschaffen ist, das diese Multimedia-Referenz anzeigt oder abspielt. Das Plugin, also das Zusatzprogramm oder Programm-Modul, das etwa für das Abspielen eines Videos oder einer Sound-Datei im Browser zuständig ist, muss über eine Java-Schnittstelle verfügen. Andernfalls erhalten Sie bei Netscape JavaScript-Fehlermeldungen von der Sorte Java object has no field or method named ....
Konqueror 3.3 interpretiert das Objekt embeds
nicht.
Speichert die Höhe eines eingebundenen Multimediaobjekts.
Anzeigebeispiel: So sieht's aus
<html><head><title>Test</title></head> <body onload="alert('Objekthöhe: ' + document.embeds[0].height + ' Pixel')"> <embed src="breeze.mid" width="300" height="200"></embed><br> </body></html>
Das Beispiel enthält eine Multimedia-Referenz einer Midi-Datei. Nachdem die HTML-Datei vollständig geladen ist, wird in einem Meldungsfenster die Höhe des referenzierten Objekts ausgegeben. Dazu ist im <body>
-Tag der Event-Handler onload
notiert.
Speichert die Angabe zum horizontalen Abstand zwischen einer Multimedia-Referenz und ihren nebenliegenden Elementen, wie sie mit dem Attribut hspace
im <embed>
-Tag möglich ist.
Anzeigebeispiel: So sieht's aus
<html><head><title>Test</title></head><body> <embed src="../../../html/multimedia/anzeige/yippee.wav" width="200" height="100" hspace="30" align="left"></embed><br> <a href="javascript:alert(document.embeds[0].hspace)">hspace anzeigen!</a> </body></html>
Das Beispiel enthält eine Multimedia-Referenz und einen Verweis. Beim Anklicken des Verweises wird mit alert() der Wert ausgegeben, der im Attribut hspace
angegeben ist.
Das Beispiel wird von Opera ab Version 6 nicht mehr interpretiert.
Speichert die Anzahl der eingebetteten Objekte im Dokument.
Anzeigebeispiel: So sieht's aus
<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>
Das Beispiel enthält eine Multimedia-Referenz. Nach dem Laden des Dokumentes wird mit alert() die Anzahl der Multimedia-Elemente ausgegeben.
Speichert den Namen eines eingebetteten Objektes, wie er mit dem Attribut name
im einleitenden <embed>
-Tag vergeben worden ist. Wenn die Angabe im HTML-Tag fehlt, enthält die Objekteigenschaft name
keinen Wert.
Anzeigebeispiel: So sieht's aus
<html><head><title>Test</title></head> <body> <embed autostart="false" name="Musik" src="breeze.mid" width="300" height="200"></embed> <a href="javascript:document.embeds['Musik'].play()">Starten</a> </body></html>
Das Beispiel enthält eine Multimedia-Referenz und einen Verweis. Nach Anklicken des Verweises wird mit document.embeds['Musik']
das Multimedia-Element angesprochen und unter Verwendung der Methode play() der Abspielvorgang gestartet.
Safari kennt das Attribut name
, unterstützt jedoch nicht die Methode play()
, so dass das Beispiel nicht funktioniert.
Datenquelle des Multimediaobjektes.
Anzeigebeispiel: So sieht's aus
<html><head><title>Test</title></head> <body> <embed src="breeze.mid" autostart="true" name="Musik" width="300" height="200"></embed> <br> <script type="text/javascript"> document.write("Download".link(document.embeds["Musik"].src)); </script> </body></html>
Im Beispiel ist eine Multimedia-Referenz definiert. Im nachfolgenden JavaScript-Bereich wird mit der Methode link() ein Verweis ins Dokument geschrieben. Der Methode wird dabei als Verweisziel die Quelldatei der Multimedia-Referenz durch Auslesen der src
-Eigenschaft mit document.embeds["Musik"].src
übergeben.
Speichert die Breite eines eingebundenen Multimediaobjekts.
Anzeigebeispiel: So sieht's aus
<html><head><title>Test</title></head> <body onload="alert('Objektbreite: ' + document.embeds[0].width + ' Pixel')"> <embed src="breeze.mid" width="300" height="200"></embed><br> </body></html>
Das Beispiel enthält eine Multimedia-Referenz einer Midi-Datei. Nachdem die HTML-Datei vollständig geladen ist, wird in einem Meldungsfenster die Breite des referenzierten Objekts ausgegeben. Dazu ist im <body>
-Tag der Event-Handler onload
notiert.
Gibt den MIME-Typ der Multimedia-Referenz, so wie er im Attribut type
definiert wurde, an. Wurde diese Eigenschaft nicht definiert, so enthält die Eigenschaft null
bzw. undefinied
im Internet Explorer.
Anzeigebeispiel: So sieht's aus
<html><head><title>Test</title></head> <body onload="alert('Objekttyp: ' + document.embeds[0].type)"> <embed src="breeze.mid" width="300" height="200" type="audio/x-midi"></embed><br> </body></html>
Das Beispiel enthält eine Multimedia-Referenz einer Midi-Datei. Nachdem die HTML-Datei vollständig geladen ist, wird in einem Meldungsfenster der Typ des referenzierten Objekts ausgegeben. Dazu ist im <body>
-Tag der Event-Handler onload notiert.
Speichert die Angabe zum vertikalen Abstand zwischen einer Multimedia-Referenz und ihren darüber- bzw. darunterliegenden Elementen, wie sie mit dem Attribut vspace
im <embed>
-Tag möglich ist.
Anzeigebeispiel: So sieht's aus
<html><head><title>Test</title></head><body> Eine Multimedia-Element<br> <embed type="audio/x-wav" src="../../../html/multimedia/anzeige/yippee.wav" width="200" height="100" vspace="30" align="left"></embed><br> <a href="javascript:alert(document.embeds[0].vspace)">Vertikalen Abstand anzeigen!</a> </body></html>
Das Beispiel enthält eine Multimedia-Referenz und einen Verweis. Beim Anklicken des Verweises wird mit alert() der Wert ausgegeben, der im Attribut vspace
angegeben ist.
Das Beispiel wird von Opera ab Version 6 nicht mehr interpretiert.
Startet das Abspielen einer Multimedia-Referenz. Der Befehl spricht eine Schnittstelle des Abspielgerätes an. Seine Wirkungsweise ist deshalb immer abhängig vom verwendeten Plugin und steht nicht in jedem Fall zur Verfügung.
Anzeigebeispiel: So sieht's aus
<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()">Starten</a> </body></html>
Das Beispiel enthält eine Multimedia-Referenz und einen Verweis. Nach Anklicken des Verweises wird mit document.embeds[0].play()
das Multimedia-Element angesprochen und der Abspielvorgang gestartet.
Beendet das Abspielen einer Multimedia-Referenz. Der Befehl spricht eine Schnittstelle des Abspielgerätes an. Seine Wirkungsweise ist deshalb immer abhängig vom verwendeten Plugin und steht nicht in jedem Fall zur Verfügung.
Anzeigebeispiel: So sieht's aus
<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()">Stoppen</a> </body></html>
Das Beispiel enthält eine Multimedia-Referenz und einen Verweis. Nach Anklicken des Verweises wird mit document.embeds[0].stop()
das Multimedia-Element angesprochen und der Abspielvorgang beendet.
layers | |
images | |
SELFHTML/Navigationshilfen JavaScript/DOM Objektreferenz |
© 2005 Impressum