<caption>: Das Tabellenbeschriftungselement

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.

* Some parts of this feature may have varying levels of support.

Das <caption> HTML Element spezifiziert die Beschriftung (oder den Titel) einer Tabelle und bietet der Tabelle eine zugängliche Beschreibung.

Probieren Sie es aus

<table> <caption> He-Man and Skeletor facts </caption> <tr> <td></td> <th scope="col" class="heman">He-Man</th> <th scope="col" class="skeletor">Skeletor</th> </tr> <tr> <th scope="row">Role</th> <td>Hero</td> <td>Villain</td> </tr> <tr> <th scope="row">Weapon</th> <td>Power Sword</td> <td>Havoc Staff</td> </tr> <tr> <th scope="row">Dark secret</th> <td>Expert florist</td> <td>Cries at romcoms</td> </tr> </table> 
caption { caption-side: bottom; padding: 10px; font-weight: bold; } table { border-collapse: collapse; border: 2px solid rgb(140 140 140); font-family: sans-serif; font-size: 0.8rem; letter-spacing: 1px; } th, td { border: 1px solid rgb(160 160 160); padding: 8px 10px; } th { background-color: rgb(230 230 230); } td { text-align: center; } tr:nth-child(even) td { background-color: rgb(250 250 250); } tr:nth-child(odd) td { background-color: rgb(240 240 240); } .heman { font: 1.4rem molot, sans-serif; text-shadow: 1px 1px 1px #fff, 2px 2px 1px #000; } .skeletor { font: 1.7rem rapscallion, fantasy; letter-spacing: 3px; text-shadow: 1px 1px 0 #fff, 0 0 9px #000; } 

Attribute

Dieses Element umfasst die globalen Attribute.

Veraltete Attribute

Die folgenden Attribute sind veraltet und sollten nicht verwendet werden. Sie sind unten zur Referenz bei der Aktualisierung bestehender Codes und aus historischem Interesse dokumentiert.

align Veraltet

Gibt an, auf welcher Seite der Tabelle die Beschriftung angezeigt werden soll. Die möglichen enumerierten Werte sind left, top, right oder bottom. Verwenden Sie stattdessen die caption-side und text-align CSS-Eigenschaften, da dieses Attribut veraltet ist.

Nutzungshinweise

  • Wenn das <caption> Element enthalten ist, muss es das erste Kind des übergeordneten <table> Elements sein.
  • Wenn eine <table> innerhalb eines <figure> als einziger Inhalt geschachtelt ist, sollte sie über eine <figcaption> für das <figure> beschriftet werden, anstatt als ein <caption> innerhalb der <table>.
  • Jeder angewendete background-color einer Tabelle wird nicht auf deren Beschriftung angewendet. Fügen Sie dem <caption> Element ebenfalls eine background-color hinzu, wenn Sie dieselbe Farbe hinter beiden haben möchten.

Beispiel

Siehe <table> für ein vollständiges Tabellenbeispiel, das gängige Standards und bewährte Verfahren einführt.

Tabelle mit Beschriftung

Dieses Beispiel zeigt eine grundlegende Tabelle, die eine Beschriftung enthält, die die dargestellten Daten beschreibt.

Ein solcher "Titel" ist für Benutzer hilfreich, die die Seite schnell überfliegen. Er ist besonders vorteilhaft für sehbeeinträchtigte Nutzer, da er ihnen ermöglicht, schnell die Relevanz der Tabelle festzustellen, ohne dass ein Screenreader die Inhalte vieler Zellen lesen muss, nur um zu erfahren, worum es in der Tabelle geht.

HTML

Ein <caption> Element wird als erstes Kind der <table> verwendet, mit einem Textinhalt, der einem Titel ähnelt, um die Tabellendaten zu beschreiben. Drei Zeilen, wobei die erste eine Kopfzeile mit zwei Spalten ist, werden unter Verwendung der <tr>, <th> und <td> Elemente nach dem <caption> erstellt.

html
<table> <caption> User login email addresses </caption> <tr> <th>Login</th> <th>Email</th> </tr> <tr> <td>user1</td> <td>user1@example.com</td> </tr> <tr> <td>user2</td> <td>user2@example.com</td> </tr> </table> 

CSS

Einige grundlegende CSS-Anweisungen werden verwendet, um das <caption> auszurichten und hervorzuheben.

css
caption { caption-side: top; text-align: left; padding-bottom: 10px; font-weight: bold; } 

Ergebnis

Technische Zusammenfassung

Inhaltskategorien Keine.
Erlaubter Inhalt Fließender Inhalt.
Tag-Auslassung Das End-Tag kann ausgelassen werden, wenn das Element nicht unmittelbar von ASCII-Leerzeichen oder einem Kommentar gefolgt wird.
Erlaubte Eltern Ein <table> Element, als dessen erster Nachkomme.
Implizierte ARIA-Rolle caption
Erlaubte ARIA-Rollen Keine role erlaubt
DOM-Schnittstelle [`HTMLTableCaptionElement`](/de/docs/Web/API/HTMLTableCaptionElement)

Spezifikationen

Specification
HTML
# the-caption-element

Browser-Kompatibilität

Siehe auch