CKTIS / HTML
span — liczba kolumn dla col i colgroup
Atrybut span określa liczbę kolumn reprezentowanych przez col albo colgroup. Przyjmuje liczby całkowite od 1 do 1000 i nie scala komórek tabeli.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
<col span="n">
<colgroup span="n"></colgroup>
<!-- n: integer from 1 to 1000 -->Atrybut span elementu col określa, ile kolejnych kolumn ten element reprezentuje. W elemencie colgroup bez elementów col określa liczbę kolumn w grupie. Nie jest to element span ani atrybut globalny.
Poprawna wartość to liczba całkowita od 1 do 1000. W modelu tabeli brak atrybutu, błąd parsowania lub zero oznaczają 1; wartości większe niż 1000 są ograniczane do 1000. Obsługa błędów nie czyni takich wartości poprawnymi.
Jeśli colgroup ma atrybut span, musi być pusty. Aby umieścić w nim elementy col, pomiń span na colgroup; zakres grupy wynika wtedy z elementów col. Atrybut span nie scala komórek: do rozciągania komórki na kolumny służy colspan na td lub th.
W przykładzie pierwsza grupa obejmuje dwie kolumny, a col w drugiej reprezentuje następne dwie. Właściwość DOM span odzwierciedla atrybut w interfejsie HTMLTableColElement. Wynik 2 2 4 pokazuje obie wartości i cztery osobne komórki.
Przykłady
<!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>Wynik
2 2 4
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.