CKTIS / HTML
span — nombre de colonnes pour col et colgroup
L’attribut span indique combien de colonnes un élément col ou colgroup représente. Il accepte des entiers de 1 à 1000 et ne fusionne pas les cellules du tableau.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<col span="n">
<colgroup span="n"></colgroup>
<!-- n: integer from 1 to 1000 -->L’attribut span de col indique combien de colonnes consécutives cet élément représente. Sur un colgroup qui ne contient pas d’éléments col, il indique le nombre de colonnes du groupe. Il ne s’agit ni de l’élément span ni d’un attribut global.
Une valeur conforme est un entier compris entre 1 et 1000. Dans le modèle des tableaux, l’absence de l’attribut, une erreur d’analyse ou la valeur zéro signifie 1 ; les valeurs supérieures à 1000 sont plafonnées à 1000. La récupération après erreur ne rend pas ces valeurs conformes.
Un colgroup doté d’un attribut span doit être vide. Pour y placer des éléments col, omettez span sur le colgroup ; l’étendue du groupe dépend alors de ses éléments col. L’attribut span ne fusionne pas les cellules : utilisez colspan sur td ou th pour qu’une cellule s’étende sur plusieurs colonnes.
Dans l’exemple, le premier groupe couvre deux colonnes, et le col du second représente les deux suivantes. La propriété DOM span reflète l’attribut via HTMLTableColElement. Le résultat 2 2 4 affiche les deux valeurs et quatre cellules distinctes.
Exemples
<!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>Résultat
2 2 4
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.