CKTIS / HTML
span — número de colunas para col e colgroup
O atributo span especifica quantas colunas um elemento col ou colgroup representa. Aceita números inteiros de 1 a 1000 e não combina células da tabela.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
<col span="n">
<colgroup span="n"></colgroup>
<!-- n: integer from 1 to 1000 -->O atributo span de col especifica quantas colunas consecutivas esse elemento representa. Num colgroup sem elementos col, especifica o número de colunas do grupo. Não é o elemento span nem um atributo global.
Um valor conforme é um número inteiro de 1 a 1000. No modelo de tabelas, a ausência do atributo, um erro de análise ou o valor zero significa 1; os valores superiores a 1000 são limitados a 1000. A recuperação de erros não torna esses valores conformes.
Um colgroup com o atributo span tem de estar vazio. Para incluir elementos col, omita span no colgroup; a extensão do grupo passa então a depender dos respetivos elementos col. O atributo span não combina células: utilize colspan em td ou th para fazer uma célula abranger várias colunas.
No exemplo, o primeiro grupo abrange duas colunas e o col do segundo representa as duas seguintes. A propriedade DOM span reflete o atributo através de HTMLTableColElement. O resultado 2 2 4 apresenta ambos os valores e quatro células separadas.
Exemplos
<!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>Resultado
2 2 4
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.