Zum Inhalt springen

HTML <caption>-Tag

Das &lt;caption&gt;-Tag wird verwendet, um einen Titel oder eine Beschreibung für eine Tabelle zu definieren. Es ist kein Spaltenkopf (verwenden Sie dafür &lt;th&gt;). Das Tag selbst muss sich unmittelbar nach dem öffnenden Tag im <table>-Element befinden und muss das erste Kindelement seines übergeordneten &lt;table&gt;-Elements sein. Pro Tabelle ist nur eine Beschriftung erlaubt.

Wenn das &lt;table&gt;-Element, das &lt;caption&gt; enthält, das einzige Nachfahrenelement des &lt;figure&gt;-Elements ist, müssen Sie stattdessen das &lt;figcaption&gt;-Element verwenden.

Standardmäßig ist eine Tabellenbeschriftung zentriert über der Tabelle ausgerichtet. Sie können die text-align und caption-side-Eigenschaften verwenden, um sie auszurichten und zu positionieren.

Syntax

Das &lt;caption&gt;-Tag wird in Paaren verwendet. Der Inhalt wird zwischen dem öffnenden (&lt;caption&gt;) und dem schließenden (&lt;&#8203;/caption&gt;) Tag geschrieben.

Beispiel für das HTML &lt;caption&gt;-Tag:

HTML &lt;caption&gt;-Tag

html
<!DOCTYPE html>
<html>
  <head>
    <title>Title of the document</title>
    <style>
      table { width: 400px; border-collapse: collapse; }
      th, td { border: 1px solid #000; padding: 4px; }
    </style>
  </head>
  <body>
    <table>
      <caption>Evaluation paper</caption>
      <thead>
        <tr>
          <th>Student</th>
          <th>1st exam</th>
          <th>2nd exam</th>
        </tr>
      </thead>
      <tbody>
        <tr>
          <td>John Johnson</td>
          <td>75</td>
          <td>65</td>
        </tr>
        <tr>
          <td>Mary Nicolson</td>
          <td>55</td>
          <td>80</td>
        </tr>
        <tr>
          <td>Max Thomson</td>
          <td>60</td>
          <td>47</td>
        </tr>
      </tbody>
    </table>
  </body>
</html>

Ergebnis

Student1st exam2nd exam
John Johnson7565
Mary Nicolson5580
Max Thomson6047

Beispiel für das HTML &lt;caption&gt;-Tag mit der CSS caption-side-Eigenschaft:

Beispiel für das HTML &lt;caption&gt;-Tag mit der CSS caption-side-Eigenschaft

html
<!DOCTYPE html>
<html>
  <head>
    <title>Title of the document</title>
    <style>
      caption {
        background: #1c87c9;
        color: #fff;
        caption-side: bottom;
      }
      table,
      th,
      td {
        border: 1px solid #1c87c9;
        padding: 3px;
      }
      td {
        background-color: #cccccc;
        color: #666666;
      }
    </style>
  </head>
  <body>
    <h2>Caption-side property example</h2>
    <p>Here the caption-side is set to "bottom":</p>
    <table>
      <caption>Some title here</caption>
      <thead>
        <tr>
          <th>Header 1</th>
          <th>Header 2</th>
        </tr>
      </thead>
      <tbody>
        <tr>
          <td>Some text</td>
          <td>Some text</td>
        </tr>
      </tbody>
    </table>
  </body>
</html>

Attribute

AttributWertBeschreibung
alignleft, right, center, top, bottomRichtet die Beschriftung horizontal oder vertikal aus. In HTML5 nicht mehr verwendet. Verwenden Sie stattdessen CSS caption-side.

Das &lt;caption&gt;-Tag unterstützt die Globalen Attribute und die Ereignisattribute.

Für eine bessere Barrierefreiheit stellen Sie sicher, dass die Beschriftung programmatisch mit der Tabelle verknüpft ist, damit Screen Reader sie korrekt vorlesen können. Das &lt;caption&gt;-Element wird automatisch mit seinem übergeordneten &lt;table&gt;-Element verknüpft.

So stylen Sie ein HTML &lt;caption&gt;-Tag

json
{
    "tag_name": "caption"
}

Praxis

Welche der folgenden Aussagen über das HTML <caption>-Tag ist laut dem Artikel auf w3docs.com korrekt?

Finden Sie das nützlich?

Dual-run-Vorschau — vergleichen Sie mit den Symfony-Routen live.