![]() |
embeds |
|
|
Eigenschaften:
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(), sodass 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. undefined 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.
|
| |
© 2007
Impressum