Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

<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 Window und Document, 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 eines name eines 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

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

Browser-Kompatibilität

Siehe auch