<figure>: Das Figurenelement 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, potentiell mit einer optionalen Beschriftung, die mit dem <figcaption>-Element spezifiziert wird. Die Figur, ihre Beschriftung und ihr Inhalt werden als eine Einheit referenziert.

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.

Verwendungshinweise

  • Üblicherweise ist ein <figure> ein Bild, eine Illustration, ein Diagramm, ein Code-Schnipsel etc., das im Hauptfluss eines Dokuments referenziert wird, aber in einen anderen Teil des Dokuments oder in einen Anhang verschoben werden kann, ohne den Hauptfluss zu beeinträchtigen.
  • Eine Beschriftung kann mit dem <figure>-Element assoziiert werden, indem ein <figcaption> darin eingefügt wird (als erstes oder letztes Kind). Das erste im <figure> gefundene <figcaption>-Element wird als die Beschriftung der Figur dargestellt.
  • Das <figcaption> bietet 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-Schnipsel

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 Flussinhalt, fühlbarer Inhalt.
Zulässiger Inhalt Ein <figcaption>-Element, gefolgt von Flussinhalt; oder Flussinhalt gefolgt von einem <figcaption>-Element; oder Flussinhalt.
Tag-Auslassung Keine, sowohl das Anfangs- als auch das End-Tag sind obligatorisch.
Zulässige Eltern Jedes Element, das Flussinhalt akzeptiert.
Implizite ARIA-Rolle figure
Zulässige ARIA-Rollen Ohne figcaption Nachfahre: beliebig, ansonsten keine zulässigen Rollen
DOM-Schnittstelle [`HTMLElement`](/de/docs/Web/API/HTMLElement)

Spezifikationen

Specification
HTML
# the-figure-element

Browser-Kompatibilität

Siehe auch