<colgroup>: Das Table Column Group-Element
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 <colgroup>
HTML-Element definiert eine Gruppe von Spalten innerhalb einer Tabelle.
Probieren Sie es aus
<table> <caption> Superheros and sidekicks </caption> <colgroup> <col /> <col span="2" class="batman" /> <col span="2" class="flash" /> </colgroup> <tr> <td></td> <th scope="col">Batman</th> <th scope="col">Robin</th> <th scope="col">The Flash</th> <th scope="col">Kid Flash</th> </tr> <tr> <th scope="row">Skill</th> <td>Smarts, strong</td> <td>Dex, acrobat</td> <td>Super speed</td> <td>Super speed</td> </tr> </table>
.batman { background-color: #d7d9f2; } .flash { background-color: #ffe8d4; } table { border-collapse: collapse; border: 2px solid rgb(140 140 140); font-family: sans-serif; font-size: 0.8rem; letter-spacing: 1px; } caption { caption-side: bottom; padding: 10px; } th, td { border: 1px solid rgb(160 160 160); padding: 8px 6px; } td { text-align: center; }
Attribute
Dieses Element enthält die globalen Attribute.
span
-
Gibt die Anzahl der aufeinanderfolgenden Spalten an, die das
<colgroup>
-Element umfasst. Der Wert muss eine positive ganze Zahl größer als Null sein. Wenn nicht vorhanden, ist sein Standardwert1
.Hinweis: Das
span
-Attribut ist nicht zulässig, wenn es ein oder mehrere<col>
-Elemente innerhalb des<colgroup>
gibt.
Veraltete Attribute
Die folgenden Attribute sind veraltet und sollten nicht verwendet werden. Sie sind nur als Referenz für die Aktualisierung bestehenden Codes und aus historischem Interesse dokumentiert.
align
Veraltet-
Gibt die horizontale Ausrichtung jeder Zellengruppe an. Die möglichen aufzählbaren Werte sind
left
,center
,right
,justify
undchar
. Wenn unterstützt, richtet derchar
-Wert den Textinhalt auf das imchar
-Attribut definierte Zeichen und den imcharoff
-Attribut definierten Versatz aus. Beachten Sie, dass die Nachkommen-<col>
-Elemente diesen Wert mit ihrem eigenenalign
-Attribut überschreiben können. Verwenden Sie stattdessen dietext-align
CSS-Eigenschaft für die<td>
- und<th>
-Elemente, da dieses Attribut veraltet ist.Hinweis: Das Setzen von
text-align
auf dem<colgroup>
-Element hat keine Wirkung, da<td>
- und<th>
-Elemente keine Nachkommen des<colgroup>
-Elements sind und daher nicht von ihm erben.Wenn die Tabelle kein
colspan
-Attribut verwendet, verwenden Sie dentd:nth-of-type(an+b)
CSS-Selektor pro Spalte, wobeia
die Gesamtanzahl der Spalten in der Tabelle undb
die Ordnungsposition der Spalte in der Tabelle ist, z. B.td:nth-of-type(7n+2) { text-align: right; }
, um die Zellen der zweiten Spalte rechts auszurichten.Wenn die Tabelle ein
colspan
-Attribut verwendet, kann der Effekt durch die Kombination geeigneter CSS-Attributselektoren wie[colspan=n]
erzielt werden, obwohl dies nicht trivial ist. bgcolor
Veraltet-
Definiert die Hintergrundfarbe jeder Zellengruppe. Der Wert ist eine HTML-Farbe; entweder ein 6-stelliger hexadezimaler RGB-Code, der mit einem
#
beginnt, oder ein Farbschlüsselwort. Andere CSS<color>
-Werte werden nicht unterstützt. Verwenden Sie stattdessen diebackground-color
CSS-Eigenschaft, da dieses Attribut veraltet ist. char
Veraltet-
Hat keine Funktion. Es war ursprünglich dafür gedacht, die Ausrichtung des Inhalts an einem Zeichen jeder Zellengruppe anzugeben. Typische Werte dafür sind ein Punkt (
.
), wenn versucht wird, Zahlen oder Geldwerte auszurichten. Wennalign
nicht aufchar
gesetzt ist, wird dieses Attribut ignoriert, obwohl es immer noch als Standardwert für diealign
der<col>
-Elemente verwendet wird, die Mitglieder dieser Spaltengruppe sind. charoff
Veraltet-
Hat keine Wirkung. Es war ursprünglich dafür gedacht, die Anzahl der Zeichen anzugeben, um die der Zellengruppeninhalt vom im
char
-Attribut spezifizierten Zeichen aus versetzt werden soll. valign
Veraltet-
Gibt die vertikale Ausrichtung jeder Zellengruppe an. Die möglichen aufzählbaren Werte sind
baseline
,bottom
,middle
undtop
. Beachten Sie, dass die Nachkommen-<col>
-Elemente diesen Wert mit ihrem eigenenvalign
-Attribut überschreiben können. Verwenden Sie stattdessen dievertical-align
CSS-Eigenschaft auf den<td>
- und<th>
-Elementen, da dieses Attribut veraltet ist.Hinweis: Das Setzen von
vertical-align
auf dem<colgroup>
-Element hat keine Wirkung, da<td>
- und<th>
-Elemente keine Nachkommen des<colgroup>
-Elements sind und daher nicht von ihm erben.Wenn die Tabelle kein
colspan
-Attribut verwendet, verwenden Sie dentd:nth-of-type()
-CSS-Selektor pro Spalte, z. B.td:nth-of-type(2) { vertical-align: middle; }
, um die Zellen der zweiten Spalte vertikal zu zentrieren.Wenn die Tabelle ein
colspan
-Attribut verwendet, kann der Effekt durch die Kombination geeigneter CSS-Attributselektoren wie[colspan=n]
erzielt werden, obwohl dies nicht trivial ist. width
Veraltet-
Gibt eine Standardbreite für jede Spalte in der aktuellen Spaltengruppe an. Zusätzlich zu den Standardpixel- und Prozentwerten kann dieses Attribut die spezielle Form
0*
annehmen, was bedeutet, dass die Breite jeder umspannten Spalte die minimale Breite ist, die notwendig ist, um den Inhalt der Spalte aufzunehmen. Auch relative Breiten wie5*
können verwendet werden. Beachten Sie, dass die Nachkommen-<col>
-Elemente diesen Wert mit ihrem eigenenwidth
-Attribut überschreiben können. Verwenden Sie stattdessen diewidth
CSS-Eigenschaft, da dieses Attribut veraltet ist.
Hinweise zur Verwendung
- Das
<colgroup>
sollte innerhalb einer<table>
erscheinen, nach einem<caption>
-Element (falls verwendet), aber vor allen<thead>
,<tbody>
,<tfoot>
und<tr>
-Elementen. - Nur eine begrenzte Anzahl von CSS-Eigenschaften wirken sich auf
<colgroup>
aus:background
: Die verschiedenenbackground
-Eigenschaften setzen den Hintergrund für Zellen innerhalb der Spaltengruppe. Da die Hintergrundfarbe der Spaltengruppe über der Tabelle, jedoch hinter den auf die Spalten (<col>
), die Zeilengruppen (<thead>
,<tbody>
, und<tfoot>
), die Zeilen (<tr>
), und die einzelnen Zellen (<th>
und<td>
) angewendet wird, sind Hintergründe, die auf Spaltengruppen von Tabellen angewendet werden, nur sichtbar, wenn jede Schicht, die darauf gemalt wird, einen transparenten Hintergrund hat.border
: Die verschiedenenborder
-Eigenschaften gelten, jedoch nur, wenn<table>
border-collapse: collapse
gesetzt hat.visibility
: Der Wertcollapse
für eine Spaltengruppe führt dazu, dass alle Zellen der Spalten in dieser Spaltengruppe nicht gerendert und in andere Spalten übergreifende Zellen abgeschnitten werden. Der Platz, den diese Spalten in der Spaltengruppe eingenommen hätten, wird entfernt. Die Größe anderer Spalten wird jedoch weiterhin berechnet, als ob die Zellen in den zusammengebrochenen Spalten in der Spaltengruppe vorhanden wären. Andere Werte fürvisibility
haben keine Wirkung.width
: Diewidth
-Eigenschaft definiert eine Mindestbreite für die Spalten innerhalb der Spaltengruppe, als obmin-width
gesetzt wäre.
Beispiel
Sehen Sie sich <table>
für ein vollständiges Tabellenbeispiel an, das gängige Standards und bewährte Verfahren vorstellt.
Dieses Beispiel zeigt eine Tabelle mit sieben Spalten, die in zwei <colgroup>
-Elemente unterteilt ist, die mehrere Spalten umfassen.
HTML
Zwei <colgroup>
-Elemente werden verwendet, um eine Basistabelle durch die Erstellung von Spaltengruppen zu strukturieren. Die Anzahl der Spalten in jeder Spaltengruppe wird durch das span
-Attribut angegeben.
<table> <caption> Personal weekly activities </caption> <colgroup span="5" class="weekdays"></colgroup> <colgroup span="2" class="weekend"></colgroup> <tr> <th>Mon</th> <th>Tue</th> <th>Wed</th> <th>Thu</th> <th>Fri</th> <th>Sat</th> <th>Sun</th> </tr> <tr> <td>Clean room</td> <td>Football training</td> <td>Dance Course</td> <td>History Class</td> <td>Buy drinks</td> <td>Study hour</td> <td>Free time</td> </tr> <tr> <td>Yoga</td> <td>Chess Club</td> <td>Meet friends</td> <td>Gymnastics</td> <td>Birthday party</td> <td>Fishing trip</td> <td>Free time</td> </tr> </table>
CSS
Gruppierte Spalten können verwendet werden, um die Struktur visuell mit CSS hervorzuheben:
table { border-collapse: collapse; border: 2px solid rgb(140 140 140); } caption { caption-side: bottom; padding: 10px; } th, td { border: 1px solid rgb(160 160 160); padding: 8px 6px; text-align: center; } .weekdays { background-color: #d7d9f2; } .weekend { background-color: #ffe8d4; }
Ergebnis
Technische Zusammenfassung
Inhaltskategorien | Keine. |
---|---|
Erlaubter Inhalt | Wenn das span -Attribut vorhanden ist: keiner.Wenn das Attribut nicht vorhanden ist: null oder mehr <col> -Elemente |
Tag-Weglassen | Der Start-Tag kann weggelassen werden, wenn er ein <col> -Element als sein erstes Kind hat und ihm kein <colgroup> vorangeht, dessen End-Tag weggelassen wurde.Der End-Tag kann weggelassen werden, wenn ihm kein Leerzeichen oder ein Kommentar folgt. |
Erlaubte Eltern | Ein <table> -Element. Der <colgroup> muss nach jedem <caption> -Element, aber vor jedem <thead> , <tbody> , <tfoot> und <tr> -Element erscheinen. |
Implizierte ARIA-Rolle | Keine entsprechende Rolle |
Erlaubte ARIA-Rollen | Keine role erlaubt |
DOM-Schnittstelle | [`HTMLTableColElement`](/de/docs/Web/API/HTMLTableColElement) |
Spezifikationen
Specification |
---|
HTML # the-colgroup-element |
Browser-Kompatibilität
Siehe auch
- Lernen: Grundlagen von HTML-Tabellen
<caption>
,<col>
,<table>
,<tbody>
,<td>
,<tfoot>
,<th>
,<thead>
,<tr>
: Weitere tabellenbezogene Elementebackground-color
: CSS-Eigenschaft zur Festlegung der Hintergrundfarbe jeder Zellengruppeborder
: CSS-Eigenschaft, um die Rahmen der Zellengruppen zu steuerntext-align
: CSS-Eigenschaft zur horizontalen Ausrichtung des Inhalts jeder Zellengruppevertical-align
: CSS-Eigenschaft zur vertikalen Ausrichtung des Inhalts jeder Zellengruppevisibility
: CSS-Eigenschaft, um Zellen einer Zellengruppe auszublenden (oder anzuzeigen)width
: CSS-Eigenschaft zur Steuerung der Standardbreite jeder Spalte in einer Spaltengruppe:nth-of-type
,:first-of-type
,:last-of-type
: CSS-Pseudoklassen, um die gewünschten Spaltenzellen auszuwählen