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. Le balisage des tableaux complique souvent l'édition des pages.

Résumé des balises wiki des tableaux

{|	début de tableau, obligatoire
|+	Légende du tableau, optionnelle ; une seule fois, entre le début du tableau et la première ligne
|-	Ligne de tableau, optionnel sur la première ligne -- le moteur de wiki pose par défaut la première ligne
!	cellule en-tête de tableau, optionnelle. Les en-têtes peuvent être mises soit sur la même ligne séparées par des doubles points d'exclamations (!!), soit au début de nouvelles lignes, chacune ayant son unique point d'exclamation (!).
|	cellule données de tableau, optionnelle. Les cellules de données de tableau consécutives peuvent être soit mises sur la même ligne séparées par deux barres verticales (||), soit sur des lignes distinctes, chacune ayant son unique barre verticale (|).
|}	Fin de tableau, obligatoire

• Les marqueurs ci-dessus doivent commencer de nouvelles lignes sauf les doubles || et !! pour écrire plusieurs cellules consécutives sur une même ligne. Les espaces en début de ligne sont ignorées.
• 'Attributs HTML'. Chaque marqueur, hormis celui de fin de tableau, peut accepter un ou plusieurs attributs HTML. Les attributs doivent être sur ls même ligne que le marqueur. Séparez les attributs l'un de l'autre avec une seule espace.
  • Les cellules et les légendes (| ou ||, ! ou !!, et|+) sont des contenants. Séparer les attributs du contenu avec une seule 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 marqueur de ligne, le parseur va supprimer celui-ci et le dernier attribut s'il touchait la barre verticale en trop.
• Le contenu peut (a) suivre le marqueur de cellule sur la même ligne après les attributs HTML éventuels ou (b) ê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. : liste, en-tête ou table incluse) devrait figurer sur sa propre ligne.
  • Caractère barre verticale comme contenu. Pour insérer une barre verticale (|) dans un tableau, utilisez <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 style plus tableau, les cellules d'une même rangée peuvent se trouver sur la même ligne, séparées par des || (deux barres verticales). Si le texte de la cellule doit contenir un saut de ligne, utilisez <br/> à la place.

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

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 « | » (la barre verticale). 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 comme dans l'en-tête de « Élément », utiliser une barre verticale « | » pour la séparation. Et non pas le 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 nutritionnels |- |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 en HTML

Vous pouvez utiliser les attributs HTML colspan et rowspan sur les cellules pour une 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 HTML

Vous pouvez ajouter des attributs HTML 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 des quatre 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 nombres sont pour top (haut), right (droite), bottom (bas), left (gauche) (et dans cet ordre).

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

Lorsqu'il y a moins de quatre valeurs, la valeur de left (gauche) prend sa valeur par défaut de right (droite), la valeur de bottom (bas) prend sa valeur par défaut de top (haut) et la valeur de right (droite) prend sa valeur par défaut 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

• Pour les attributs HTML (tels que « width= », « border= », « cellspacing= » et « cellpadding= »), l'unité de longueur par défaut est en pixels. Ils sont également non valides dans HTML5.

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 au titre 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, 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 de 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. En appliquant le style float au tableau, le texte va entourer le tableau au lieu de simplement être aligné. 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 : 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 commencez une cellule sur une nouvelle ligne avec un nombre précédé d'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 CSS plutôt que l'attribut border seront traitées incorrectement dans un petit sous-ensemble de navigateurs Web en mode 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