<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
oderbottom
. Verwenden Sie stattdessen diecaption-side
undtext-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 einebackground-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.
<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.
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
- Lernen: Grundlagen von HTML-Tabellen
<col>
,<colgroup>
,<table>
,<tbody>
,<td>
,<tfoot>
,<th>
,<thead>
,<tr>
: Andere tabellenbezogene Elementecaption-side
: CSS-Eigenschaft, um das<caption>
relativ zu seinem übergeordneten<table>
zu positionierentext-align
: CSS-Eigenschaft, um den Textinhalt des<caption>
horizontal auszurichten