CKTIS / HTML
object — eine Ressource mit Ersatzinhalt einbetten
Das `object`-Element bettet eine externe Ressource als Bild oder verschachteltes Dokument ein. Seine untergeordneten Inhalte dienen als Ersatzinhalt und werden angezeigt, wenn die Ressource nicht dargestellt werden kann.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<object data="resource-url" type="mime/type" width="320" height="180">Fallback content</object>Das object-Element steht für eine externe Ressource, die je nach Typ als Bild oder verschachteltes Dokument behandelt wird. Sowohl ein Start- als auch ein End-Tag sind erforderlich. Das transparente Inhaltsmodell bedeutet, dass die zulässigen untergeordneten Elemente vom umgebenden Kontext abhängen.
Der HTML-Standard verlangt, dass mindestens eines der Attribute data und type vorhanden ist. Diese Anforderung an den HTML-Code garantiert nicht, dass die Ressource erfolgreich eingebettet wird. Ist data vorhanden, muss sein Wert eine gültige, nicht leere URL der Ressource sein — verwende hier nicht src. Das Attribut type deklariert einen MIME-Typ; es konvertiert die Daten nicht. width und height legen die Abmessungen fest, name benennt den verschachtelten Navigationskontext, falls einer erstellt wird, und form ordnet das Element ausdrücklich einem Formular zu.
Die untergeordneten Elemente sind Ersatzinhalt und keine dauerhaft angezeigte Bildunterschrift. Sie werden unter anderem angezeigt, wenn das Abrufen fehlschlägt oder ein Bild nicht unterstützt wird beziehungsweise fehlerhaft ist. Nach erfolgreicher Einbettung gehören sie nicht zum angezeigten Inhalt. Anders als object unterstützt embed diesen Ersatzinhalt nicht.
Beispiele
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Object fallback</title>
</head>
<body>
<object data="data:image/png,not-a-png" type="image/png" width="320" height="80">
<p>Image unavailable.</p>
</object>
</body>
</html>Ergebnis
Image unavailable.
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.