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

CKTIS / HTML

colspan: estender uma célula por várias colunas

Raciocina com posições na grelha da tabela, em vez de contar apenas células DOM.

Versão: HTML Living Standard

Sintaxe

<td colspan="2">Two columns</td>

Numa célula de dados ou cabeçalho, colspan especifica quantas colunas da tabela a célula abrange. São válidos inteiros entre 1 e 1000; a omissão produz uma célula de uma coluna. Zero não significa «todas as colunas restantes», ao contrário da regra especial do zero para a extensão por linhas. As células resultantes não podem sobrepor-se no modelo da tabela.

A extensão não cria elementos de célula adicionais. Assim, cellIndex descreve a posição do elemento na coleção de células da sua linha, que pode diferir da coluna visual na grelha. Mantém associações de cabeçalhos relevantes para as tecnologias de apoio e usa dados realmente tabulares, não tabelas como ferramenta geral de disposição da página.

O ambiente de teste tem três colunas de dimensões explícitas. A primeira linha contém apenas duas células porque a primeira ocupa duas colunas; a segunda linha tem três células individuais. As verificações geométricas confirmam a largura combinada e o alinhamento da última coluna. O exemplo testa, portanto, o efeito na grelha, em vez de apenas reler o atributo.

Exemplos

<!doctype html><meta charset="utf-8">
<style>table { width:300px; table-layout:fixed; border-spacing:0; } td { padding:0; }</style>
<table><colgroup><col style="width:100px"><col style="width:100px"><col style="width:100px"></colgroup>
<tbody><tr id="joined"><td id="span" colspan="2">Two columns</td><td id="tail">Third</td></tr>
<tr><td id="a">A</td><td id="b">B</td><td id="c">C</td></tr></tbody></table><output id="result"></output>
<script>
const box = id => document.getElementById(id).getBoundingClientRect();
document.querySelector('#result').textContent = 'rowCells=' + document.querySelector('#joined').cells.length + '; coversTwo=' + (Math.abs(box('span').width - box('a').width - box('b').width) < 1) + '; thirdAligned=' + (Math.abs(box('tail').left - box('c').left) < 1);
</script>

Resultado

rowCells=2; coversTwo=true; thirdAligned=true

As medições geométricas admitem uma pequena tolerância; a afirmação diz respeito ao alinhamento, não a uma dimensão universal em píxeis.

Fontes