<figure>: Das Figure-Element mit optionaler Beschriftung

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Das <figure> HTML-Element repräsentiert eigenständigen Inhalt, möglicherweise mit einer optionalen Beschriftung, die mithilfe des <figcaption>-Elements angegeben wird. Die Figur, ihre Beschriftung und ihre Inhalte werden als eine Einheit betrachtet.

Probieren Sie es aus

<figure>
  <img
    src="/shared-assets/images/examples/elephant.jpg"
    alt="Elephant at sunset" />
  <figcaption>An elephant at sunset</figcaption>
</figure>

figure {
  border: thin #c0c0c0 solid;
  display: flex;
  flex-flow: column;
  padding: 5px;
  max-width: 220px;
  margin: auto;
}

img {
  max-width: 220px;
  max-height: 150px;
}

figcaption {
  background-color: #222;
  color: #fff;
  font: italic smaller sans-serif;
  padding: 3px;
  text-align: center;
}

Attribute

Dieses Element enthält nur die globalen Attribute.

Nutzungshinweise

In der Regel ist ein <figure> ein Bild, eine Illustration, ein Diagramm, ein Code-Snippet usw., das im Hauptfluss eines Dokuments referenziert wird, aber an eine andere Stelle des Dokuments oder in einen Anhang verschoben werden kann, ohne den Hauptfluss zu beeinflussen.
Eine Beschriftung kann dem <figure>-Element zugeordnet werden, indem ein <figcaption> innerhalb davon eingefügt wird (als erstes oder letztes Kind). Das erste im Figure-Element gefundene <figcaption>-Element wird als Beschriftung der Figur präsentiert.
Das <figcaption> liefert den zugänglichen Namen für das übergeordnete <figure>.

Beispiele

Bilder

html

<!-- Just an image -->
<figure>
  <img src="favicon-192x192.png" alt="The beautiful MDN logo." />
</figure>

<!-- Image with a caption -->
<figure>
  <img src="favicon-192x192.png" alt="The beautiful MDN logo." />
  <figcaption>MDN Logo</figcaption>
</figure>

Ergebnis

Code-Snippets

html

<figure>
  <figcaption>Get browser details using <code>navigator</code>.</figcaption>
  <pre>
function NavigatorExample() {
  var txt;
  txt = "Browser CodeName: " + navigator.appCodeName + "; ";
  txt+= "Browser Name: " + navigator.appName + "; ";
  txt+= "Browser Version: " + navigator.appVersion  + "; ";
  txt+= "Cookies Enabled: " + navigator.cookieEnabled  + "; ";
  txt+= "Platform: " + navigator.platform  + "; ";
  txt+= "User-agent header: " + navigator.userAgent  + "; ";
  console.log("NavigatorExample", txt);
}
  </pre>
</figure>

Ergebnis

Zitate

html

<figure>
  <figcaption><b>Edsger Dijkstra:</b></figcaption>
  <blockquote>
    If debugging is the process of removing software bugs, then programming must
    be the process of putting them in.
  </blockquote>
</figure>

Ergebnis

Gedichte

html

<figure>
  <p style="white-space:pre">
    Bid me discourse, I will enchant thine ear, Or like a fairy trip upon the
    green, Or, like a nymph, with long dishevelled hair, Dance on the sands, and
    yet no footing seen: Love is a spirit all compact of fire, Not gross to
    sink, but light, and will aspire.
  </p>
  <figcaption><cite>Venus and Adonis</cite>, by William Shakespeare</figcaption>
</figure>

Ergebnis

Technische Zusammenfassung

Inhaltskategorien	Fließinhalten, verfügbare Inhalte.
Erlaubte Inhalte	Ein `<figcaption>`-Element, gefolgt von Fließinhalten; oder Fließinhalte gefolgt von einem `<figcaption>`-Element; oder Fließinhalte.
Tag-Auslassung	Keine, sowohl das öffnende als auch das schließende Tag sind erforderlich.
Zulässige Eltern	Jedes Element, das Fließinhalte akzeptiert.
Implizite ARIA-Rolle	Abbildung
Zulässige ARIA-Rollen	Ohne figcaption-Nachfahr: beliebig, sonst keine erlaubten Rollen
DOM-Schnittstelle	[`HTMLElement`](/de/docs/Web/API/HTMLElement)

Spezifikationen

Specification
HTML # the-figure-element

Browser-Kompatibilität

Siehe auch

Das <figcaption>-Element.