mitmario.dev

<embed>

Das <embed> Element bettet externe Inhalte wie PDFs, Bilder oder andere Plugin-Inhalte direkt in deine Webseite ein. Historisch war es die Schnittstelle zu Browser-Plugins wie Flash oder Java Applets. Heute wird es hauptsächlich für PDFs genutzt, wobei <iframe> in den meisten Fällen die bessere und modernere Wahl ist.

Steckbrief <embed>
Kategorie
Links & Medien
Art
Leeres Element
Attribute
4
Beispiele
3
Browser
5 von 5
E-Mail
0 von 5
Stand
06.02.2026

Grundlagen

7 Punkte
  • Void-Element: Kein schließendes Tag notwendig
  • Bettet externe Ressourcen direkt in die Seite ein
  • Benötigt das src-Attribut mit der URL der Ressource
  • Historisch für Browser-Plugins (Flash, Java), heute meist für PDFs
  • Alternative: <iframe> bietet mehr Kontrolle und Sicherheit
  • Unterstützt width und height zur Größensteuerung
  • Der type-Parameter hilft dem Browser, das richtige Plugin zu wählen

Syntax

<embed src="dokument.pdf" type="application/pdf" width="600" height="400">

Das <embed> Element ist ein Void-Element und wird ohne schließendes Tag geschrieben. Die Angabe des type-Attributs ist optional, aber empfohlen.

Attribute

4 Attribute
Attribut und Beispiel Beschreibung
src URL
src="dokument.pdf"
URL der einzubettenden Ressource. Pflichtattribut.
type String
type="application/pdf"
MIME-Typ der Ressource (z.B. application/pdf, image/svg+xml). Hilft dem Browser, das richtige Plugin zu wählen.
width Number
width="600"
Breite des eingebetteten Inhalts in Pixeln.
height Number
height="400"
Höhe des eingebetteten Inhalts in Pixeln.

Beispiele

3 Beispiele
<embed
  src="handbuch.pdf"
  type="application/pdf"
  width="800"
  height="600"
>

Das ist der häufigste Anwendungsfall: Ein PDF-Dokument wird direkt in die Seite eingebettet. Beachte, dass nicht alle mobilen Browser PDF-Plugins haben.

Sicherheit

Das <embed> Element hat einige Sicherheitsaspekte, die du beachten solltest:

  • Eingebettete Inhalte können Sicherheitsrisiken darstellen
  • Vertraue nur Quellen, die du kontrollierst
  • PDFs können JavaScript enthalten (potenzielle Gefahr)
  • Historische Browser-Plugins (Flash, Java) waren häufige Angriffsvektoren
  • <iframe> bietet bessere Sandbox-Optionen und mehr Sicherheitskontrolle
  • Verwende HTTPS-URLs für externe Ressourcen
  • Content Security Policy (CSP) kann <embed> einschränken

Empfehlung: Nutze wenn möglich <iframe> statt <embed>, da es modernere Sicherheitsfeatures bietet.

Barrierefreiheit

Das <embed> Element hat bekannte Barrierefreiheitsprobleme:

  • Keine native Unterstützung für alternative Texte
  • Screenreader haben oft Probleme mit eingebetteten Inhalten
  • Fokus-Management funktioniert nicht immer zuverlässig
  • Mobile Geräte unterstützen oft keine Plugins

Bessere Alternativen für Barrierefreiheit:

<!-- Besser: Direkter Link zum PDF -->
<a href="dokument.pdf" download>Dokument herunterladen (PDF, 2 MB)</a>

<!-- Oder mit iframe und Fallback -->
<iframe src="dokument.pdf" width="100%" height="600">
  <p>Dein Browser kann keine PDFs anzeigen.
    <a href="dokument.pdf" download>Hier herunterladen</a>
  </p>
</iframe>

Häufige Fehler

Fehlendes src-Attribut

<!-- Falsch: Kein src -->
<embed type="application/pdf">

<!-- Richtig -->
<embed src="dokument.pdf" type="application/pdf">

Das src-Attribut ist zwingend erforderlich, sonst weiß der Browser nicht, was er einbetten soll.

Schließendes Tag verwenden

<!-- Falsch: embed ist ein Void-Element -->
<embed src="file.pdf"></embed>

<!-- Richtig: Kein schließendes Tag -->
<embed src="file.pdf">

<embed> ist ein Void-Element und darf kein schließendes Tag haben.

Keine Fallback-Lösung

<!-- Problematisch: Was wenn das Plugin fehlt? -->
<embed src="wichtig.pdf">

<!-- Besser: Direkter Link als Alternative -->
<embed src="wichtig.pdf">
<p><a href="wichtig.pdf">PDF direkt öffnen</a></p>

Anders als <object> hat <embed> keine native Fallback-Unterstützung. Stelle immer einen alternativen Zugang bereit.

Browser-Kompatibilität

5 von 5

Das <embed> Element wird von allen modernen Browsern unterstützt, aber die Unterstützung spezifischer Inhaltstypen hängt von installierten Plugins ab.

  • Chrome

    Komplett

  • Firefox

    Komplett

  • Safari

    Komplett

  • Edge

    Komplett

  • Opera

    Komplett

Beachte: Die Browser-Unterstützung für das Element selbst ist vollständig, aber nicht alle Browser haben integrierte PDF-Viewer oder andere Plugin-Unterstützung. Mobile Browser haben oft gar keine Plugin-Unterstützung.

Email-Kompatibilität

0 von 5

Das <embed> Element wird in HTML-Emails nicht unterstützt und sollte niemals verwendet werden.

  • Gmail

    Keine

    Wird komplett entfernt

  • Outlook

    Keine

    Wird komplett entfernt

  • Apple Mail

    Keine

    Wird komplett entfernt

  • Thunderbird

    Keine

    Wird komplett entfernt

  • Yahoo Mail

    Keine

    Wird komplett entfernt

Aus Sicherheitsgründen blockieren alle Email-Clients externe Plugins und eingebettete Inhalte. Verwende stattdessen direkte Links zu Dokumenten.

Newsletter

einmal die Woche, kostenlos

Neue Artikel und Videos, was sich auf der Lernplattform tut, und ab und zu ein Sonderpreis zum Kursstart. Kurz genug, dass du es auch liest.

Zuletzt verschickt · KW 40

Einmal alles neu, und die Lernplattform ist da

Danach kommt eine Mail mit Bestätigungslink, erst dann bist du eingetragen. Abmelden geht unten in jeder Ausgabe. Mehr dazu in der Datenschutzerklärung.