Aide:Tableau

Un tableau est un outil de mise en page, servant à mettre en évidence des données chiffrées 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 un icône « Tableau » Fichier:Vector toolbar insert table button.png présent dans la fenêtre de modifications, dans l'onglet « Avancé ».

Syntaxe d'un tableau élémentaire

• Un tableau s’ouvre avec le code : {|.

La plupart des tableaux utilisent la classe wikitable, s'écrivant : class="wikitable".

L'usage de la classe wikitable simplifie et harmonise la mise en forme des tableaux de données.

Par défaut, un tableau se positionne à gauche, mais peut être centré avec : class="wikitable centre" (ou center).

Pour améliorer la lisibilité des grands tableaux, une alternance de gris peut être appliquée avec : class="wikitable alternance".

• Le titre du tableau est défini par : |+.

Le titre du tableau se place en début de tableau, avant la première rangée de cellules. Si plusieurs titres sont indiqués, seul le premier est pris en compte.

• Une nouvelle ligne est créée dans un tableau avec le code : |-.

Le nombre de tirets dans |- n'est pas limité, on peut en ajouter pour rendre le code wiki plus lisible ; par exemple : |------.

Le code |- est ignoré s’il n’est pas suivi de contenu suivi de nouvelles cellules.

• Une nouvelle cellule (ou case) est créée dans un tableau avec le code : | (si le contenu des cellules est décrit verticalement) ; ou bien : || (si disposé horizontalement).

Il est possible de laisser des cellules vides. Dans la disposition à l'horizontale, il est alors important de toujours placer au moins une espace avant les deux barres verticales séparant deux cellules, afin de clairement identifier les cellules et attributs de cellules.

• Un en-tête de colonne est créé par : ! scope="col".

L'en-tête de colonne se place sur la 1Modèle:Re ligne (avant la première ligne de contenu), c'est-à-dire après le premier |-.

• Un en-tête de ligne est créé par : ! scope="row".

L'en-tête de ligne se place au début de chaque ligne, c'est-à-dire après chaque |-.

Par défaut dans la classe wikitable, le texte des en-têtes est affiché en gras, tous les en-têtes prennent une couleur de fond différente, et les en-têtes de colonnes sont centrés tandis que les en-têtes de lignes sont alignés à gauche.

En syntaxe wiki, le point d’exclamation est utilisé à la place de la barre verticale pour définir des en-têtes.

• Un tableau se ferme avec le code : |}.

Exemple récapitulatif

Résultat affiché

Code

Titre Titre col. A Titre col. B Titre col. C Titre ligne 1 Donnée 1A Donnée 1B Donnée 1C Titre ligne 2 Donnée 2A Donnée 2B Donnée 2C Titre ligne 3 Donnée 3A Donnée 3B Donnée 3C

{| 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 1A | Donnée 1B | Donnée 1C |-  ! scope="row" | Titre ligne 2 | Donnée 2A | Donnée 2B | Donnée 2C |-  ! scope="row" | Titre ligne 3 | Donnée 3A | Donnée 3B | Donnée 3C |} 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 1A || Donnée 1B || Donnée 1C |----  ! scope="row" | Titre ligne 2 | Donnée 2A || Donnée 2B || Donnée 2C |----  ! scope="row" | Titre ligne 3 | Donnée 3A || Donnée 3B || Donnée 3C |}

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 pixels 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="bottom"| . Les valeurs possibles sont top et bottom

• Pour fusionner horizontalement x cellules, on utilise la fonction colspan="x" (expansion de x colonnes) : ||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 le code.

• Pour fusionner verticalement x cellules, on utilise la fonction rowspan="x" (expansion de x rangées) : ||rowspan="2"|. La 1Modèle: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 le code.

• Les tableaux peuvent être triés.

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 en-tê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-après.

Exemple bilan

Le tableau ci-après 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 million 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:16500000}} || 2003 |- | Belgique || 2 || align="right" | 10 millions || 2007 |- | Luxembourg || 3 || align="right" | {{formatnum:0.5}} million || |-class="sortbottom" ! Benelux || colspan="3" | Total : 27 M |}

Références

• Cette page est partiellement ou en totalité issue de l'article intitulé « Aide:Insérer un tableau (wikicode, avancé) Aide:Insérer_un_tableau_(wikicode,_avancé) », sur la Wikipédia francophone, publié sous licence CC-BY-SA.
  (Consultez l'Aide:Insérer un tableau (wikicode, avancé) historique de la page originale pour connaître la liste de ses auteurs).