<object>-HTML-Element für externe Objekte
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Das HTML-Element <object> repräsentiert eine externe Ressource, die als Bild, verschachtelter Browsing-Kontext oder von einem Plugin zu verarbeitende Ressource behandelt werden kann.
Probieren Sie es aus
<object
type="video/mp4"
data="/shared-assets/videos/flower.mp4"
width="250"
height="200"></object>
Attribute
Dieses Element umfasst die globalen Attribute.
archive-
Eine durch Leerzeichen getrennte Liste von URIs für Archive von Ressourcen für das Objekt.
border-
Die Breite eines Rahmens um das Steuerelement in Pixeln.
classid-
Die URI der Implementierung des Objekts. Sie kann zusammen mit oder anstelle des Attributs data verwendet werden.
codebase-
Der Basispfad, der zum Auflösen relativer URIs verwendet wird, die durch classid, data oder archive angegeben werden. Wenn nicht angegeben, ist die Basis-URI des aktuellen Dokuments der Standardwert.
codetype-
Der Inhaltstyp der durch classid angegebenen Daten.
data-
Die Adresse der Ressource als gültige URL. Mindestens eines von data und type muss definiert sein.
declare-
Das Vorhandensein dieses booleschen Attributs macht dieses Element nur zu einer Deklaration. Das Objekt muss durch ein nachfolgendes
<object>-Element instanziiert werden. Wiederholen Sie das<object>-Element vollständig, jedes Mal wenn die Ressource erneut verwendet wird. form-
Das Formularelement, falls vorhanden, mit dem das Objektelement verknüpft ist (sein form owner). Der Wert des Attributs muss eine ID eines
<form>-Elements im selben Dokument sein. height-
Die Höhe der angezeigten Ressource, als
<integer>in CSS-Pixeln. name-
Der Name eines gültigen Browsing-Kontexts (HTML5) oder der Name des Steuerelements (HTML 4). Der Name wird zu einer Eigenschaft der Objekte
WindowundDocument, die eine Referenz auf das eingebettete Fenster oder das Element selbst enthält. standby-
Eine Meldung, die der Browser während des Ladens der Implementierung und Daten des Objekts anzeigen kann.
type-
Der Inhaltstyp der durch data angegebenen Ressource. Mindestens eines von data und type muss definiert sein.
usemap-
Eine Hash-Namensreferenz auf ein
<map>-Element; das heißt ein#, gefolgt vom Wert einesnameeines Map-Elements. width-
Die Breite der angezeigten Ressource, als
<integer>in CSS-Pixeln.
Hinweise zur Verwendung
Das <object>-Element kann PDFs mithilfe des integrierten PDF-Viewers des Browsers anzeigen. Seine Kindelemente stellen Fallback-Inhalte bereit, wenn die Ressource nicht angezeigt werden kann. Sie können dies verwenden, um einen Link zum PDF bereitzustellen, sollten jedoch auch außerhalb des Elements einen Link bereitstellen, damit dieser verfügbar bleibt, wenn der Viewer geladen wird, das PDF jedoch nicht anzeigen kann.
Im Gegensatz zu <iframe> verfügt <object> über keine Attribute zur Steuerung des Ladens. Die Content Security Policy der einbettenden Seite steuert ihre Quellen über object-src.
Beispiele
>Ein Video einbetten
HTML
<object
type="video/webm"
data="/shared-assets/videos/flower.webm"
width="600"
height="140">
<img
src="/api/v1/web-embed/proxy?proxyUrl=https%3A%2F%2Fdeveloper.mozilla.org%2Fshared-assets%2Fimages%2Fexamples%2Fflowers.jpg&mode=full"
alt="Some beautiful flowers" />
</object>
Ergebnis
Wenn das Video im Beispiel nicht geladen werden kann, wird dem Benutzer ein Bild als Fallback-Inhalt bereitgestellt. Das Tag <img> wird verwendet, um ein Bild anzuzeigen. Wir fügen das Attribut src hinzu, das auf den Pfad zu dem Bild gesetzt ist, das wir einbetten möchten. Außerdem fügen wir das Attribut alt hinzu, das dem Bild einen zugänglichen Namen gibt. Wenn auch das Bild nicht geladen werden kann, wird der Inhalt des Attributs alt angezeigt.
Technische Zusammenfassung
| Inhaltskategorien |
Flow-Inhalt;
Phrasing-Inhalt;
eingebetteter Inhalt, wahrnehmbarer Inhalt; wenn das Element ein
usemap-Attribut hat, interaktiver Inhalt;
gelistet,
übermittelbar
formularassoziiertes Element.
|
|---|---|
| Erlaubter Inhalt |
null oder mehr <param>-Elemente, anschließend
transparent.
|
| Weglassen von Tags | Keines, sowohl Start- als auch End-Tag sind erforderlich. |
| Erlaubte Elternelemente | Jedes Element, das eingebetteten Inhalt akzeptiert. |
| Implizite ARIA-Rolle | Keine entsprechende Rolle |
| Erlaubte ARIA-Rollen |
application, document, img
|
| DOM-Schnittstelle | [`HTMLObjectElement`](/de/docs/Web/API/HTMLObjectElement) |
Spezifikationen
| Spezifikation |
|---|
| HTML> # the-object-element> |