Une page de Wikipédia, l'encyclopédie libre.
Un tableau est un outil de mise en page, servant à mettre en évidence des données chiffrés ou des listes. Cette page d'aide présente les fonctions les plus fréquentes pour construire un tableau.
Si vous souhaitez directement obtenir des tableaux prêts à remplir, il existe une icône « Tableau »
présente dans la fenêtre de modifications, dans l'onglet « Avancé ».
Les tableaux posant fréquemment des problèmes d'accessibilité, plusieurs instructions sont présentes sur Wikipédia:Atelier accessibilité/Bonnes pratiques#Tableaux, pour respecter les principales conventions de navigation.
[modifier] Syntaxe d'un tableau élémentaire
- Un tableau s’ouvre avec :
{|.
- La plupart des tableaux appliquent le style wikitable, s'écrivant :
class="wikitable".
- L'usage de la classe wikitable, plus élégant qu'un tableau classique, est encouragé dans le but d'harmoniser l'apparence des tableaux dans les articles. Il impose certains attributs (comme la taille de la bordure) et définit des couleurs par défaut. Le tableau peut être centré avec les codes :
gauche, centre et droite.
- Un tableau se positionne par défaut à gauche.
- Une alternance de gris peut-être appliqué au tableau avec :
class="wikitable alternance"
- Le titre du tableau est défini par :
|+.
-
- Le code du titre du tableau se place en début du tableau, avant la première rangée de cellules. Si plusieurs titres sont indiqués, seul le premier est pris en compte.
- Une nouvelle cellule (c'est à dire une case) est crée dans un tableau avec :
|.
- Le code de ces cellules peut être disposées verticalement, ou horizontalement avec le code. À l’horizontale, il faut mettre deux barres verticales entre chaque cellules. Il est possible de laisser des cellules sans aucun contenu, cependant dans la configuration à l'horizontale, il est important de toujours placer au moins une espace avant les deux barres verticales séparant deux cellules, afin d'identifier clairement les différentes cellules et attributs de cellules.
- Une nouvelle ligne est crée dans un tableau avec le code :
|-.
- Le code
|- est ignoré s’il n’est pas suivi de contenu suivit de nouvelles cellules. Le nombre de tiret dans |- n'est pas limité, on peut en ajouter pour rendre le code Wiki plus lisible, par exemple : |------.
- Une en-tête de colonne est crée par :
! scope=col.
- L'entête des colonnes se classe avant la première ligne de contenu, c'est à dire le premier
|-.
- Une en-tête de ligne est crée par :
! scope=row.
- L'entête de ligne se classe au début de chaque ligne, c'est à dire après chaque
|-.
- Visuellement, le texte des en-têtes est généralement en gras. Dans la classe
wikitable, tous ces entêtes prennent une couleur de fond différente, et seuls les en-têtes de colonnes sont centrés, les en-têtes de ligne restent alignés à gauche par défaut.
- Un tableau se ferme avec le code:
|}.
[modifier] Exemple récapitulatif
| Résultat affiché |
Code |
Titre
|
Titre col. A |
Titre col. B |
Titre col. C |
| Titre ligne 1 |
donnée L1-A |
donnée L1-B |
donnée L1-C |
| Titre ligne 2 |
donnée L2-A |
donnée L2-B |
donnée L2-C |
| Titre ligne 3 |
donnée L3-A |
donnée L3-B |
donnée L3-C |
|
{|class="wikitable alternance centre"
|+ Titre
|-
|
!scope="col"| Titre col. A
!scope="col"| Titre col. B
!scope="col"| Titre col. C
|-
!scope="row"| Titre ligne 1
| donnée L1-A
| donnée L1-B
| donnée L1-C
|-
!scope="row"| Titre ligne 2
| donnée L2-A
| donnée L2-B
| donnée L2-C
|-
!scope="row"| Titre ligne 3
| donnée L3-A
| donnée L3-B
| donnée L3-C
|}
ou
{|class="wikitable alternance centre"
|+ Titre
|----
|
!scope="col"| Titre col. A !scope="col"| Titre col. B !scope="col"| Titre col. C
|----
| !scope="row"| Titre ligne 1 | donnée L1-A ||donnée L1-B || donnée L1-C
|----
| !scope="row"| Titre ligne 2 | donnée L2-A || donnée L2-B || donnée L2-C
|----
| !scope="row"| Titre ligne 3 | donnée L3-A || donnée L3-B || donnée L3-C
|}
|
[modifier] Syntaxe supplémentaire
- Pour définir la largeur d'un élément, on utilise la fonction
width="x%" : en début de tableau {| width="100px", ou de cellule ||width="50px"|. La largeur est le plus souvent exprimée en px et en %. Les % sont recommandés car s'adaptant à l'écran du lecteur.
- Pour définir l'alignement vertical du texte, on utilise la fonction
valign="x" : tableau {| valign="top" , ligne |- valign="top", case ||valign="top"| . Les valeurs possibles sont top et bottom
- Pour fusionner horizontalement x cellules, on utilise la fonction
colspan="x" (colonnes expansion x) : ||colspan="2"|. La première cellule à gauche doit être paramétrée, l'extension se fait en mangeant les cellules de droite. Les cellules mangées ne doivent pas être présentes dans votre code.
- Pour fusionner verticalement x cellules, on utilise la fonction
rowspan="x" (étage expansion x) : ||rowspan="2"|. La 1ère cellule du haut doit être paramétrée, l'extension se fait vers le bas. Les cases mangées ne doivent pas être présentes dans votre code.
- Les tableaux peuvent être triés. Le triage est cependant à utiliser avec parcimonie dans les articles, allant à l'encontre de normes d'accessibilité. Un tableau devient triable, lorsque celui commence par :
{| class="wikitable sortable"
- Une colonne devient fixe et non triable lorsqu'on lui spécifie :
||class="unsortable"|
- Une ligne devient fixe et non triable lorsqu'on lui spécifie :
|- class="sortbottom"
- Les tableaux triables s'identifient grâce aux flèches de tri des entêtes.
- Les tableaux ayant des cellules fusionnées sur plusieurs rangées (rowspan) ou colonnes (colspan) ou ayant des cellules manquantes en fin de ligne ne se trient pas correctement. Il est recommandé d'utiliser la fusion de colonnes ou de lignes uniquement dans des cellules non triées, avec donc le code
"unsortable" ou "sortbottom". Voir exemple ci-dessous.
Le tableau ci-dessous est un bilan, il utilise au moins une fois chaque fonction souvent nécessaire (width, align, colspan, rowspan, sortable, style="text-align:center).
| Résultat affiché |
Codage wiki |
Benelux
| Pays |
Rang |
Population |
Date du relevé |
| Pays-Bas |
1 |
16,500,000 |
2003 |
| Belgique |
2 |
10 millions |
2007 |
| Luxembourg |
3 |
0,5 millions |
|
| Benelux |
Total : 27 M |
|
{|class="wikitable sortable centre" style="text-align:center; width=80%;"
|+ Benelux
!width="25%" | Pays || Rang || Population || Date du relevé
|-
| Pays-Bas || 1 || align="right" | {{formatnum:16.500.000}} || 2003
|-
| Belgique || 2 || align="right" | 10 millions || 2007
|-
| Luxembourg || 3 || align="right" | {{formatnum:0.5}} millions ||
|-class="sortbottom"
! Benelux || colspan="3" | Total : 27 M
|}
|