Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

colspan: extender una celda por varias columnas

Razona con posiciones de la cuadrícula de la tabla, no solo contando celdas DOM.

Versión: HTML Living Standard

Sintaxis

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

En una celda de datos o cabecera, colspan especifica cuántas columnas ocupa. Los valores válidos son enteros de 1 a 1000; omitirlo crea una celda de una columna. Cero no significa «todas las columnas restantes», a diferencia de la regla especial de cero para extenderse por filas. Las celdas resultantes no deben solaparse en el modelo de tabla.

La extensión no crea elementos de celda adicionales. Por eso, cellIndex describe la posición del elemento en la colección de celdas de su fila, que puede diferir de la columna visual de la cuadrícula. Mantén asociaciones de cabeceras significativas para las tecnologías de asistencia y usa datos realmente tabulares, no tablas como recurso general para maquetar páginas.

La prueba tiene tres columnas de tamaño explícito. Su primera fila contiene solo dos celdas porque la primera ocupa dos columnas; la segunda tiene tres celdas individuales. Las comprobaciones geométricas confirman el ancho combinado y la alineación de la última columna. Así, el ejemplo prueba el efecto en la cuadrícula en vez de limitarse a leer el atributo.

Ejemplos

<!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

Se permite una pequeña tolerancia en las mediciones geométricas; la afirmación trata de alineación, no de un tamaño universal en píxeles.

Fuentes