Help:Tables

Note : Si vous modifiez cette page, vous acceptez de placer votre contribution sous licence CC0. Plus d'informations sont disponibles sur les pages d'aide du projet domaine public. Edit · Translate

Pour la structure des tables de la base de données MediaWiki, voir Manuel:Schéma de base de donnéeManual:Database layout

Des Tableaux peuvent être créés dans les pages wiki. En règle générale, il est préférable d'éviter d'utiliser un tableau à moins d'en avoir vraiment besoin. Le balisage des tableaux complique souvent l'édition des pages.

Résumé des balises des tableaux Wiki

{|	début de tableau
|+	descriptif du contenu, optionnel; un seul par tableau positionné entre le début du tableau et la première ligne
|-	début de ligne, optionnel sur la première ligne -- le moteur de wiki prend en charge la première ligne
!	cellule entête, optionnel. Les entêtes peuvent être mises soit sur la même ligne séparées par des doubles points d'exclamations (!!), soit sur des lignes séparées, chacune ayant son unique point d'exclamation (!).
|	cellule données de tableau, optionnel. Les cellules de données consécutives d'un tableau peuvent être soit mises sur la même ligne séparées par une double barre verticale (||), soit sur des lignes séparées, chacune ayant son unique barre verticale (|).
|}	fin de tableau

• Les marqueurs ci-dessus sont sur des lignes séparées sauf les doubles || et !! pour écrire plusieurs cellules consécutives sur une même ligne.
• *Attributs XHTML : Chaque marqueur, hormis celui de fin de tableau, peut accepter un ou plusieurs attributs XHTML. Les attributs doivent être sur le même ligne que le marqueur. Séparez les attributs l'un de l'autre avec un simple espace.
  • Les cellules et les résumés (| ou ||, ! ou !!, et |+) sont des contenants. Il faut séparer les attributs du contenu avec une barre verticale (|). Le contenu d'une cellule peut suivre sur la même ligne ou des lignes consécutives.
  • Les marqueurs de tableaux et de lignes ({| et |-) ne sont pas à proprement parler des contenants. Ne pas ajouter de barre verticale (|) après leurs attributs éventuels. Si par erreur vous ajoutez une barre verticale après les attributs d'un marqueur de table ou de ligne, le parseur va supprimer celui-ci et le dernier attribut s'il touchait la barre verticale en trop.
• 'Le Contenu' peut
  • soit suivre le marqueur de cellule sur la même ligne après les attributs XHTML éventuels
  • soit être sur les lignes suivant le marqueur de cellule. Un contenu qui utilise un marqueur wiki ayant besoin d'être placé sur une nouvelle ligne (ex. : nouvelle ligne, liste, entête ou table incluse) devrait bien sûr figurer sur sa propre ligne.
  • Caractère tube comme contenu. Pour insérer un caractère tube (|) dans un tableau, utilisez la balise <nowiki>|</nowiki> pour échapper au balisage.

Généralités

Le tableau suivant manque de bordure, d'espacement correct mais montre la structure de tableau wiki la plus simple possible

Vous tapez	Vous obtenez
{| |Orange |Pomme |- |Pain |Tarte |- |Beurre |Crème glacée |}	Orange Pomme Pain Tarte Beurre Crème glacée

Pour un look plus tableau, les marqueurs de cellule peuvent être sur la même ligne, séparés par des ||. Si le texte de la cellule doit contenir un saut de ligne, utilisez <br /> à la place.

Vous tapez	Vous obtenez
{| |Orange||Pomme||plus… |- |Pain||Gâteau||plus… |- |Beurre||Crème<br />glacée||et<br />plus |}	Orange Pomme plus… Pain Gâteau plus… Beurre Crème glacée et plus

Des espaces supplémentaires dans le texte brut, comme dans le texte suivant, n'affectent pas le rendu final du tableau.

Vous tapez	Vous obtenez
{| | Orange || Pomme || plus... |- | Pain || Tarte || plus… |- | Beurre || Crème glacée || et plus |}	Orange Pomme plus… Pain Tarte plus… Beurre Crème glacée et plus...

Vous pouvez aussi placer du texte plus long ou une syntaxe plus complexe à l'intérieur des cellules du tableau:

Vous tapez

Vous obtenez

{| |Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. | * Lorem ipsum dolor sit amet * consetetur sadipscing elitr * sed diam nonumy eirmod tempor invidunt |}

Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet consetetur sadipscing elitr sed diam nonumy eirmod tempor invidunt

En-têtes de tableau

Les en-têtes de tableau peuvent être créés en utilisant "!" (le point d'exclamation) au lieu de |" (le symbole tube). Les titres apparaissent centrés et en gras par défaut.

Vous tapez	Vous obtenez
{| ! style="text-align:left;"| Élément ! Montant ! Coût |- |Orange |10 |7.00 |- |Pain |4 |3.00 |- |Beurre |1 |5.00 |- !Total | |15.00 |}	Élément Montant Coût Orange 10 7.00 Pain 4 3.00 Beurre 1 5.00 Total 15.00

Note: Lorsque l'on veut utiliser des attributs pour les lignes de titres, on fait appel à des barres verticales '|' (AltGr+8) pour la séparation. Et non pas un point d'exclamation '!'.

Titre

Un titre de tableau peut être ajouté au sommet de n'importe quel tableau comme ce qui suit:

Vous tapez	Vous obtenez
{| |+Compléments nutritionels |- |Orange |Pomme |- |Pain |Tarte |- |Beurre |Crème glacée |}	Compléments nutritionels Orange Pomme Pain Tarte Beurre Crème glacée

class="wikitable"

Le style de base (fond gris clair, bordures, espacements des bordures et alignement) peuvent être précisé en ajoutant class="wikitable".

Vous tapez	Vous obtenez
{| class="wikitable" |+Compléments nutritionels |- |Orange |Pomme |- |Pain |Tarte |- |Beurre |Crème glacée |}	Compléments nutritionels Orange Pomme Pain Tarte Beurre Crème glacée

Colspan et rowspan HTML

Vous pouvez utiliser les attributs HTML colspan et rowspan sur les cellules pour la mise en page avancée.

Vous tapez	Vous obtenez
{| class="wikitable" !colspan="6"|Liste des courses |- |rowspan="2"|Pain et beurre |Tarte |brioches |Danois |colspan="2"|Croissant |- |Fromage |colspan="2"|Crème glacée |Beurre |Yaourt |}	Liste de courses Pain et beurre Tarte brioches Danois Croissant Fromage Crème glacée Beurre Yaourt

Attributs XHTML

Vous pouvez ajouter des attributs XHTML aux tableaux. Pour la source faisant autorité sur ceux-ci, voir La page de spécifications HTML du W3C sur les tableaux.

Attributs dans les tableaux

Placer des attributs après la balise de début de tableau ({|) applique les attributs à la totalité du tableau.

Vous tapez	Vous obtenez
{| class="wikitable" style="text-align: center; color: green;" |Orange |Pomme |12,333.00 |- |Pain |Tarte |500.00 |- |Beurre |Crème glacée |1.00 |}	Orange Pomme 12,333.00 Pain Tarte 500.00 Beurre Crème glacée 1.00

Attributs dans les cellules

Il est possible de mettre des attributs dans des cellules individuelles. Par exemple, les nombres peuvent sembler mieux s'ils sont alignés à droite.

Vous tapez	Vous obtenez
{| class="wikitable" | Orange | Pomme | style="text-align:right;" | 12,333.00 |- | Pain | Tarte | style="text-align:right;" | 500.00 |- | Beurre | Crème glacée | style="text-align:right;" | 1.00 |}	Orange Pomme 12,333.00 Pain Tarte 500.00 Beurre Crème glacée 1.00

Il est également possible d'utiliser les attributs de cellules lorsque l'on liste des cellules multiples sur une ligne simple. Notez que les cellules sont séparées par ||, et que dans chaque cellule les attributs et les valeurs sont séparés par des |.

Vous tapez	Vous obtenez
{| class="wikitable" | Orange || Pomme || style="text-align:right;" | 12,333.00 |- | Pain || Tarte || style="text-align:right;" | 500.00 |- | Beurre || Crème glacée || style="text-align:right;" | 1.00 |}	Orange Pomme 12,333.00 Pain Tarte 500.00 Beurre Crème glacée 1.00

Attributs des lignes

Vous pouvez également mettre des attributs sur des lignes individuelles.

Vous tapez	Vous obtenez
{| class="wikitable" | Orange | Pomme | style="text-align:right;"| 12,333.00 |- | Pain | Tarte | style="text-align:right;"| 500.00 |- style="font-style: italic; color: green;" | Beurre | Crème glacée | style="text-align:right;"| 1.00 |}	Orange Pomme 12,333.00 Pain Tarte 500.00 Beurre Crème glacée 1.00

Bordure de tableau simple d'un pixel

Exemple de tableau avec une bordure d'un pixel:

Vous tapez	Vous obtenez
{| border="1" style="border-collapse:collapse" | Orange | Pomme |- | Pain | Tarte |}	Orange Pomme Pain Tarte

Épaisseur de bordure

Si "border-width:" n'a qu'un seul nombre, il définit l'épaisseur des bordures de tous les côtés.

Vous tapez	Vous obtenez
{|style="border-style: solid; border-width: 20px" | Salut |}	Salut

Si "border-width:" a plus d'un nombre, les quatre numéros sont pour haut (top), droite (right), bas (bottom), gauche (left) (Rappelez-vous cet ordre) :

Vous tapez	Vous obtenez
{|style="border-style: solid; border-width: 10px 20px 100px 0" | Salut |}	Salut

Lorsqu'il y a moins de 4 valeurs, la valeur de left (gauche) prend sa valeur par défaut de la valeur de right (droite), la valeur de bottom (bas) prend sa valeur par défaut de la valeur de top (haut) et la valeur de right (droite) prend sa valeur par défaut de la valeur de top (haut).

Une autre méthode pour définir les largeurs des quatre côtés d'une cellule est d'utiliser border-left, border-right, border-top et border-bottom

Vous tapez	Vous obtenez
{|style="border-left:solid 10px black;border-right:solid 20px black;border-top:solid 30px black;border-bottom:solid 40px black;" align="center" | Salut |}	Salut

 Note :

• Les attributs HTML (tels que "width=", "border =", "cellspacing=", "cellpadding=") ne nécessitent aucune unité de longueur (l'unité de pixel est supposé). Ils sont également non valides dans HTML 5.

Les propriétés de style CSS (qui remplacent les attributs HTML) nécessitent une unité de longueur explicite (si la valeur n'est pas 0) telle que "px" pour le pixel.

Attributs HTML et attributs de style CSS

Des attributs de style CSS peuvent être ajoutés avec ou sans autres attributs HTML.

Vous tapez	Vous obtenez
{| class="wikitable" style="color:green; background-color:#ffffcc;" cellpadding="10" |Orange |Pomme |- |Pain |Tarte |- |Beurre |Crème glacée |}	Orange Pomme Pain Tarte Beurre Crème glacée

Attributs

Les attributs peuvent être ajoutés à la légende et aux en-têtes comme suit.

Vous tapez	Vous obtenez
{| class="wikitable" |+ style="caption-side:bottom; color:#e76700;"|Compléments nutritionnels |- |Orange |Pomme |- |Pain |Tarte |- |Beurre |Crème glacée |}	Compléments nutritionels Orange Pomme Pain Tarte Beurre Crème glacée

Largeur de colonne

La largeur de colonne peut être ajoutée comme suit.

Vous tapez

{| style="color: black; background-color: #ffffcc; width: 85%;"
| colspan="2" | Cette largeur de colonne est 85% de la largeur de l'écran (et a une couleur de fond)
|-
| style="width: 30%; background-color: white;"|
'''Cette colonne est comptée à 30% à partir de 85% de la largeur de l'écran'''
| style="width: 70%; background-color: orange;"|
'''Cette colonne est comptée à 70% à partir de 85% de la largeur de l'écran (et a une couleur d'arrière-plan)'''
|}

Vous obtenez

Cette largeur de colonne est 85% de la largeur de l'écran (et a une couleur de fond)
Cette colonne est comptée à 30% à partir de 85% de la largeur de l'écran	Cette colonne est comptée à 70% à partir de 85% de la largeur de l'écran (et a une couleur d'arrière-plan)

Accessibilité des cellules d'en-tête de tableau

Les cellules d'en-tête de tableau ne spécifient pas explicitement les cellules de données de table auxquelles elles s'appliquent (celles situées à droite de la même ligne ou celles situées en dessous de celles-ci sur la même colonne). Lorsque le tableau est rendu dans un environnement 2D visuel, cela est généralement facile à déduire.

Toutefois, lorsque les tableaux sont interprétés sur des supports non visuels, vous pouvez aider le navigateur à déterminer quelle cellule d'en-tête de table s'applique à la description de toute cellule sélectionnée (afin de répéter son contenu dans une aide d'accessibilité) en utilisant un scope="row" ou scope="col" sur les cellules d'en-tête de tableau. Dans la plupart des cas avec des tableaux simples, vous utiliserez scope="col" sur toutes les cellules d'en-tête de la première ligne, et scope="row" sur la première cellule des lignes suivantes :

Vous tapez	Vous obtenez
{| class="wikitable" |- ! scope="col"| Élément ! scope="col"| Quantité ! scope="col"| Prix |- ! scope="row"| Pain | 0.3 kg | $0.65 |- ! scope="row"| Beurre | 0.125 kg | $1.25 |- ! scope="row" colspan="2"| Total | $1.90 |}	Élément Quantité Prix Pain 0.3 kg $0.65 Beurre 0.125 kg $1.25 Total $1.90

Alignement

Alignement tableau

L'alignement de tableau est réalisé en utilisant le CSS. L'alignement du tableau est contrôlé par des marges (margin). Une marge fixée d'un côté fera aligner le tableau sur ce côté, si sur le côté opposé la marge est définie comme auto. Pour avoir un tableau aligné au centre, vous devez définir les deux marges à auto

Par exemple, un tableau aligné à droite :

Vous tapez	Vous obtenez
{| class="wikitable" style="margin-left: auto; margin-right: 0px;" | Orange | Pomme |- | Pain | Tarte |- | Beurre | Crème glacée |}	Orange Pomme Pain Tarte Beurre Crème glacée

Et un tableau aligné au centre :

Vous tapez	Vous obtenez
{| class="wikitable" style="margin: auto;" | Orange | Pomme |- | Pain | Tarte |- | Beurre | Crème glacée |}	Orange Pomme Pain Tarte Beurre Crème glacée

Tableau flottant autour du texte

Si vous alignez un tableau à droite ou à gauche de la page, le texte qui vient après le tableau commence à la fin de celui-ci, laissant un espace vide autour du tableau. Vous pouvez faire que le texte soit autour du tableau en mettant le style de tableau à float autour du texte au lieu de simplement l'aligner. Cela peut être réalisé en utilisant l'attribut CSS float, qui peut spécifier où le tableau est flottant, vers la droite ou vers la gauche. Lorsque vous utilisez float, les marges ne contrôlent pas l'alignement du tableau et peuvent être utilisées pour spécifier la marge entre le tableau et le texte environnant.

Vous tapez

Vous obtenez

{| class="wikitable" style="float:right; margin-left: 10px;" | Orange | Pomme |- | Pain | Tarte |- | Beurre | Crème glacée |} Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat. Ut wisi enim ad minim veniam, quis nostrud exerci tation ullamcorper suscipit lobortis nisl ut aliquip ex ea commodo consequat. Duis autem vel eum iriure dolor in hendrerit in vulputate velit esse molestie consequat, vel illum dolore eu feugiat nulla facilisis at vero eros et accumsan et iusto odio dignissim qui blandit praesent luptatum zzril delenit augue duis dolore te feugait nulla facilisi.

Orange Pomme Pain Tarte Beurre Crème glacée Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat. Ut wisi enim ad minim veniam, quis nostrud exerci tation ullamcorper suscipit lobortis nisl ut aliquip ex ea commodo consequat. Duis autem vel eum iriure dolor in hendrerit in vulputate velit esse molestie consequat, vel illum dolore eu feugiat nulla facilisis at vero eros et accumsan et iusto odio dignissim qui blandit praesent luptatum zzril delenit augue duis dolore te feugait nulla facilisi.

Alignement du contenu de la cellule

L'alignement du contenu de la cellule peut être contrôlé par deux propriétés CSS différentes : text-align et vertical-align. text-align peut être spécifié au tableau, à la ligne ou aux cellules individuelles, tandis que vertical-align peut uniquement être spécifié sur des lignes ou des cellules individuelles.

Vous tapez

Vous obtenez

{| class="wikitable" |- style="vertical-align:top;" | style="height:100px; width:100px; text-align:left;" | A | style="height:100px; width:100px; text-align:center;" | B | style="height:100px; width:100px; text-align:right;" | C |- style="vertical-align:middle;" | style="height:100px; width:100px; text-align:left;" | D | style="height:100px; width:100px; text-align:center;" | E | style="height:100px; width:100px; text-align:right;" | F |- style="vertical-align:bottom;" | style="height:100px; width:100px; text-align:left;" | G | style="height:100px; width:100px; text-align:center;" | H | style="height:100px; width:100px; text-align:right;" | I |}

A B C D E F G H I

Avertissements

Nombres négatifs

Si vous démarrez une cellule sur une nouvelle ligne avec un nombre négatif avec un signe moins (ou un paramètre qui équvaut à un nombre négatif), votre tableau peut se briser, car les caractères |- seront analysés comme le balisage wiki pour la ligne de tableau, et pas une cellule de tableau. Pour éviter cela, insérez un espace avant la valeur (| -6) ou utilisez le balisage de ligne en ligne (|| -6).

CSS vs attributs

Les bordures de tableau spécifiées à l'aide de la fonction CSS plutôt que l'attribut border seront traitées incorrectement dans un petit sous-ensemble de navigateurs de texte.

Attributs communs pour les colonnes, les groupes de colonnes et les groupes de lignes

La syntaxe de MediaWiki pour les tableaux ne propose actuellement aucun support pour spécifier des attributs communs pour les colonnes (avec l'élément HTML <col />), les groupes de colonnes (élément HTML <colgroup></colgroup>) et des groupes de lignes (éléments HTML <thead></thead>, <tbody></tbody> et <tfoot></tfoot>). Ces éléments HTML standard ne sont pas acceptés même dans leur syntaxe HTML ou XHTML.

Toutes les lignes et cellules (en-tête ou données) du tableau sont rendues dans un seul groupe de lignes implicites (élément HTML <tbody></tbody>) sans aucun attributs ou modes.

Voir aussi

• Tri des lignes d'un tableau
• meta:Help:Sorting
• wikipedia:Help:Tables
• Outil facile qui aide à générer des tableaux
• wikipedia:Template:Horizontal TOC. Bon pour les listes de pays dans les tableaux.