WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen