WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

figcaption — eine Bildunterschrift für figure-Inhalte

Das Element `figcaption` versieht den Inhalt von `figure` mit einer Bildunterschrift. Es muss direktes Kind sein und am Anfang oder Ende stehen.

Version: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

<figure>
  <!-- Figure content -->
  <figcaption>Caption text</figcaption>
</figure>

figcaption stellt eine Bildunterschrift oder Legende für den übrigen Inhalt seines übergeordneten figure-Elements dar. Es ist nicht auf Illustrationen beschränkt: Es kann auch ein Diagramm oder eine Codeliste beschreiben. Die Bildunterschrift kann Angaben zur Quelle enthalten.

Ein figure darf höchstens ein direktes figcaption-Element enthalten, und zwar als erstes oder letztes Kind. Die Bildunterschrift ist optional. Platziere sie weder zwischen den Teilen des beschriebenen Inhalts noch in einem zusätzlichen Container statt direkt in figure.

figcaption akzeptiert Flow-Content, etwa Text, Links und Absätze. Es unterstützt globale Attribute und verwendet die DOM-Schnittstelle HTMLElement. Sowohl das öffnende als auch das schließende Tag sind erforderlich. Im Beispiel beschreibt die Bildunterschrift eine als Listing dargestellte Gleichung; sie ist nicht Teil des Codes selbst.

Beispiele

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Caption example</title>
</head>
<body>
  <figure>
    <pre><code>2 + 3 = 5</code></pre>
    <figcaption>Listing 1. An addition equation.</figcaption>
  </figure>
</body>
</html>

Ergebnis

2 + 3 = 5
Listing 1. An addition equation.

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.

Quellen