<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.
Das <caption>
HTML-Element legt die Beschriftung (oder den Titel) einer Tabelle fest und bietet der Tabelle eine zugängliche Beschreibung.
Probieren Sie es aus
Attribute
Dieses Element umfasst die globalen Attribute.
Veraltete Attribute
Die folgenden Attribute sind veraltet und sollten nicht verwendet werden. Sie sind hier dokumentiert, um beim Aktualisieren bestehenden Codes als Referenz zu dienen und aus historischem Interesse.
align
Veraltet-
Gibt an, auf welcher Seite der Tabelle die Beschriftung angezeigt werden soll. Die möglichen aufzählbaren Werte sind
left
,top
,right
oderbottom
. Verwenden Sie stattdessen diecaption-side
- undtext-align
-CSS-Eigenschaften, da dieses Attribut veraltet ist.
Anwendungshinweise
- Wenn enthalten, muss das
<caption>
-Element das erste Kind seines übergeordneten<table>
-Elements sein. - Wenn eine
<table>
innerhalb eines<figure>
verschachtelt ist und den einzigen Inhalt der Figur darstellt, sollte sie über eine<figcaption>
für die<figure>
anstelle als<caption>
innerhalb der<table>
beschriftet werden. - Jede
background-color
, die auf eine Tabelle angewendet wird, gilt nicht für deren Beschriftung. Fügen Sie einebackground-color
zum<caption>
-Element hinzu, wenn Sie möchten, dass dieselbe Farbe auch hinter der Beschriftung angezeigt wird.
Beispiel
Sehen Sie sich <table>
für ein vollständiges Tabellenbeispiel an, das gängige Standards und bewährte Praktiken einführt.
Tabelle mit Beschriftung
Dieses Beispiel zeigt eine einfache Tabelle mit einer Beschriftung, die die dargestellten Daten beschreibt.
Ein solcher "Titel" ist hilfreich für Benutzer, die die Seite schnell überfliegen, und er ist besonders vorteilhaft für sehbehinderte Benutzer, da er ihnen erlaubt, schnell die Relevanz der Tabelle zu erkennen, ohne dass ein Screenreader den Inhalt vieler Zellen vorlesen muss, nur um zu erfahren, worum es in der Tabelle geht.
HTML
Ein <caption>
-Element wird als erstes Kind der <table>
verwendet, mit Textinhalt ähnlich einem Titel, um die Tabellendaten zu beschreiben. Drei Zeilen, die erste davon eine Kopfzeile, mit zwei Spalten werden mit den <tr>
, <th>
und <td>
-Elementen nach dem <caption>
erstellt.
<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-Eigenschaften werden verwendet, um die <caption>
auszurichten und hervorzuheben.
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 | Der 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 Nachfahre.
|
Implizierte ARIA-Rolle |
caption
|
Erlaubte ARIA-Rollen | Keine role erlaubt |
DOM-Schnittstelle | [`HTMLTableCaptionElement`](/de/docs/Web/API/HTMLTableCaptionElement) |
Spezifikationen
Specification |
---|
HTML Standard # the-caption-element |
Browser-Kompatibilität
BCD tables only load in the browser
Siehe auch
- Lernen: Grundlagen von HTML-Tabellen
<col>
,<colgroup>
,<table>
,<tbody>
,<td>
,<tfoot>
,<th>
,<thead>
,<tr>
: Andere tabellenbezogene Elementecaption-side
: CSS-Eigenschaft, um die<caption>
relativ zu ihrem übergeordneten<table>
zu positionierentext-align
: CSS-Eigenschaft, um den Textinhalt der<caption>
horizontal auszurichten