CKTIS / HTML
span — Spaltenanzahl für col und colgroup
Das Attribut span gibt an, wie viele Spalten ein col- oder colgroup-Element repräsentiert. Es akzeptiert Ganzzahlen von 1 bis 1000 und führt nicht dazu, dass Tabellenzellen zusammengeführt werden.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<col span="n">
<colgroup span="n"></colgroup>
<!-- n: integer from 1 to 1000 -->Das Attribut span an einem col-Element gibt an, wie viele aufeinanderfolgende Spalten dieses Element repräsentiert. Bei einem colgroup ohne col-Elemente gibt es die Anzahl der Spalten in der Gruppe an. Es ist weder das span-Element noch ein globales Attribut.
Ein zulässiger Wert ist eine Ganzzahl von 1 bis 1000. Im Tabellenmodell bedeutet ein fehlendes Attribut, ein Parsefehler oder der Wert null 1; Werte über 1000 werden auf 1000 begrenzt. Die Fehlerbehandlung macht diese Werte nicht zulässig.
Ein colgroup mit einem span-Attribut muss leer sein. Um col-Elemente darin unterzubringen, lasse span am colgroup weg; der Umfang der Gruppe ergibt sich dann aus ihren col-Elementen. Das Attribut span führt nicht dazu, dass Zellen zusammengeführt werden: Verwende colspan an td oder th, damit sich eine Zelle über mehrere Spalten erstreckt.
Im Beispiel umfasst die erste Gruppe zwei Spalten, und das col-Element in der zweiten Gruppe repräsentiert die nächsten beiden. Die DOM-Eigenschaft span bildet das Attribut über HTMLTableColElement ab. Die Ausgabe 2 2 4 zeigt beide Werte und vier separate Zellen.
Beispiele
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Column span</title>
<table>
<caption>Four columns</caption>
<colgroup id="group" span="2"></colgroup>
<colgroup><col id="columns" span="2"></colgroup>
<tbody>
<tr><td>A</td><td>B</td><td>C</td><td>D</td></tr>
</tbody>
</table>
<pre id="result"></pre>
<script>
const group = document.getElementById('group');
const columns = document.getElementById('columns');
const cellCount = document.querySelector('tr').cells.length;
document.getElementById('result').textContent =
`${group.span} ${columns.span} ${cellCount}`;
</script>
</html>Ergebnis
2 2 4
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.