CKTIS / CSS
caption-side — position de la légende du tableau
La propriété CSS caption-side choisit le côté du tableau où apparaît sa légende. En mode d’écriture horizontal, les valeurs de base top et bottom la placent respectivement au-dessus ou au-dessous de la grille.
Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntaxe
caption-side: top | bottom;caption-side positionne une boîte de légende par rapport à la grille du tableau. La propriété s’applique aux boîtes table-caption, généralement créées par un élément caption. En mode d’écriture horizontal, top place la légende au-dessus de la grille et bottom au-dessous. La valeur initiale est top.
La propriété est héritée : une déclaration sur table peut transmettre sa valeur à la légende, sauf si celle-ci possède sa propre déclaration qui l’emporte dans la cascade. inherit reprend explicitement la valeur du parent. La position de toute la légende et l’alignement de son texte sont deux aspects distincts — utilisez text-align pour ce dernier.
Les noms top et bottom ne désignent pas le haut et le bas physiques dans tous les modes d’écriture : ils correspondent à block-start et block-end selon le mode d’écriture du bloc contenant la légende. L’extension qui ajoute inline-start et inline-end est conditionnelle ; ne supposez pas qu’elle est portable. La syntaxe de base de cette entrée se limite à top et bottom.
L’exemple définit explicitement writing-mode: horizontal-tb. La légende reste en première position dans le balisage du tableau, mais caption-side: bottom l’affiche sous les lignes. Remplacer la valeur par top devrait la déplacer au-dessus de la grille sans modifier le contenu du tableau. L’exemple nécessite une vérification locale.
Exemples
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>caption-side example</title>
<style>
table { writing-mode: horizontal-tb; border-collapse: collapse; }
caption { caption-side: bottom; text-align: left; }
th, td { border: 1px solid black; padding: 4px; }
</style>
<table>
<caption>Scores</caption>
<tr><th scope="col">Name</th><th scope="col">Points</th></tr>
<tr><td>Ada</td><td>12</td></tr>
</table>
</html>Résultat
Name | Points Ada | 12 Scores
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.