CKTIS / HTML
span — aantal kolommen voor col en colgroup
Het attribuut span geeft aan hoeveel kolommen een col- of colgroup-element vertegenwoordigt. Het accepteert gehele getallen van 1 tot en met 1000 en voegt geen tabelcellen samen.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<col span="n">
<colgroup span="n"></colgroup>
<!-- n: integer from 1 to 1000 -->Het attribuut span op col geeft aan hoeveel opeenvolgende kolommen dat element vertegenwoordigt. Op een colgroup zonder col-elementen geeft het het aantal kolommen in de groep aan. Het is niet het span-element en ook geen globaal attribuut.
Een geldige waarde is een geheel getal van 1 tot en met 1000. In het tabelmodel betekent een ontbrekend attribuut, een parsefout of nul 1; waarden boven 1000 worden begrensd op 1000. Foutafhandeling maakt zulke waarden niet geldig.
Een colgroup met een span-attribuut moet leeg zijn. Als je er col-elementen in wilt plaatsen, laat je span weg op de colgroup; de omvang van de groep volgt dan uit de col-elementen. Het attribuut span voegt geen cellen samen: gebruik colspan op td of th om een cel meerdere kolommen te laten beslaan.
In het voorbeeld beslaat de eerste groep twee kolommen en vertegenwoordigt de col in de tweede groep de volgende twee. De DOM-eigenschap span weerspiegelt het attribuut via HTMLTableColElement. De uitvoer 2 2 4 toont beide waarden en vier afzonderlijke cellen.
Voorbeelden
<!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>Resultaat
2 2 4
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.