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

CKTIS / HTML

elemento HTML: col

O elemento vazio de coluna representa uma ou mais colunas consecutivas, permitindo descrever em conjunto cobertura e apresentação.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

<colgroup><col span="2"></colgroup>

col só é permitido como filho de um colgroup sem atributo span; sendo vazio não tem filhos nem etiqueta final.

O atributo span indica uma cobertura entre 1 e 1000; valor ausente ou inválido dá a cobertura inicial de uma coluna.

col não contém células td nem cria relações de cabeçalho; a semântica dos dados continua a vir de th, scope e headers.

Só propriedades CSS limitadas afetam colunas, entre elas background, border condicional, visibility e a influência de width. O exemplo soma duas coberturas com querySelectorAll().

Exemplos

<!doctype html>
<meta charset="utf-8">
<table id="matrix">
  <colgroup id="layout"><col id="key"><col id="values" span="2"></colgroup>
  <tbody><tr><td>Key</td><td>Low</td><td>High</td></tr></tbody>
</table>
<output id="result"></output>
<script>
const matrix = document.querySelector("#matrix");
const layout = document.querySelector("#layout");
const key = document.querySelector("#key");
const values = document.querySelector("#values");
const covered = [...layout.children].reduce((sum, column) => sum + column.span, 0);
document.querySelector("#result").textContent = `cols=${layout.children.length}; covered=${covered}; keySpan=${key.span}; valueSpan=${values.span}; children=${values.childNodes.length}; cells=${matrix.rows[0].cells.length}`;
</script>

Resultado

cols=2; covered=3; keySpan=1; valueSpan=2; children=0; cells=3

O resultado confirma dois elementos que cobrem três células e o modelo vazio; não avalia a disposição final do algoritmo de largura.

Fontes