Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes