Aide:Tables

Note : si vous modifiez cette page, vous acceptez de placer votre contribution sous licence CC0. Plus d’informations sont disponibles sur le projet Aide dans le domaine public.

Tables vous redirige ici; pour la structure des tables de la base de données, voir Schéma de base de données .

Il est possible de créer des Tableaux dans les pages wiki. En règle générale, il est préférable d'éviter d'utiliser un tableau, sauf si vous en avez absolument besoin. 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 cellules consécutives d' entête de tableau peuvent être ajoutées : soit sur la même ligne séparées par des points d'exclamation doubles (!!), soit au début de nouvelles lignes, chacune ayant son point d'exclamation unique (!).
|	cellule données de tableau, optionnelle. Les cellules consécutives de données de tableau peuvent être ajoutées sur la même ligne séparées par deux barres verticales (||), ou commencer sur des lignes distinctes, chacune d'elle ayant son unique barre verticale (|).
|}	Fin de tableau, obligatoire

• Les marqueurs ci-dessus doivent commencer de nouvelles lignes sauf les doubles || et !! pour ajouter facultativement des cellules consécutives sur une même ligne. Néanmoins les espaces de début de ligne sont ignorées.
• Attributs HTML. Chaque marqueur, hormis celui de fin de tableau, peut accepter facultativement un ou plusieurs attributs HTML. Les attributs doivent être sur la même ligne que le marqueur. Séparez les attributs les uns des autres avec une seule espace.
  • Les cellules et les légendes (| ou ||, ! ou !!, et|+) sont des contenants. Séparer donc chacun des attributs, du contenu avec une seule barre verticale (|). Le contenu d'une cellule peut suivre sur la même ligne ou sur des lignes consécutives.
  • Les marqueurs de tableaux et de lignes ({| et |-) n'ont pas directement de contenu. 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 son 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 lui-même d'être placé au début d'une nouvelle ligne, tel que les listes, les en-têtes ou les tables imbriquées, doit figurer sur sa propre nouvelle ligne.
  • Caractère barre verticale comme contenu. Pour insérer le caractère barre verticale (|) dans un tableau, utilisez <nowiki>|</nowiki> pour échapper au balisage.

Généralités

Créer un tableau avec la barre d'outils de l'éditeur

Dans l'éditeur de wikicode, placez le curseur à l'endroit où vous voulez insérer le tableau. Puis dans la barre d'outils, pressez Avancé et choisissez Hello, World!. Une fenêtre de dialogue s'ouvre.

A partir du dialogue, vous pouvez choisir d'avoir une ligne d'entête, de mettre en forme le tableau avec une bordure, et de donner la possibilité à l'utilisateur de trier la table. Un exemple d'aperçu est affiché. Vous pouvez aussi définir le nombre de lignes et de colonnes que vous souhaitez. Appuyez ensuite sur le bouton Insérer.

Le code suivant est généré par défaut :

Wikicode :

{| class="wikitable" style="margin:auto"
|+ Texte de la légende
|-
! Texte de l’en-tête !! Texte de l’en-tête !! Texte de l’en-tête
|-
| Exemple || Exemple || Exemple
|-
| Exemple || Exemple || Exemple
|-
| Exemple || Exemple || Exemple
|}

Résultat :

Texte de la légende

Texte de l’en-tête	Texte de l’en-tête	Texte de l’en-tête
Exemple	Exemple	Exemple
Exemple	Exemple	Exemple
Exemple	Exemple	Exemple

Syntaxe minimale

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

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

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 entrez	Vous obtenez
{| |Orange||Pomme||plus |- |Pain||Tarte||plus |- |Beurre||Crème<br/>glacée||et<br/>plus |}	Orange Pomme plus Pain Tarte plus Beurre Crème glacée et plus

Des espaces supplémentaires entre les cellules dans le balisage wiki, comme dans le marquage wiki ci-dessous, n'affectent pas le rendu final du tableau.

Vous entrez	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 wiki plus complexe à l'intérieur des cellules du tableau :

Vous entrez

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

Entêtes de tableau

Les entê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 entrez	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

Si vous voulez mettre des attributs comme dans l' 'élément' d'entête, utilisez la barre verticale '|' comme séparateur. Et non pas le point d'exclamation « ! ».

Titre

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

Vous entrez	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 à gauche) peuvent être précisé en ajoutant class="wikitable".

Vous entrez	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 entrez	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 les attributs HTML, voir La page des spécifications HTML du W3C concernant les tableaux.

Attributs dans les tableaux

Les attributs placés après la balise de début ({|) s'appliquent à tout le tableau.

Vous entrez	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 les cellules individuelles. Par exemple, les nombres peuvent sembler mieux s'ils sont alignés à droite.

Vous entrez	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 lorsqu'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 |.

Vous entrez	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 les lignes individuelles.

Vous entrez	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

Attributs de la légende et des en-têtes

Les attributs peuvent être ajoutés au titre et aux entêtes comme suit.

Vous entrez	Vous obtenez
{| class="wikitable" |+ style="caption-side:bottom; color:#e76700;"|''Compléments nutritionnels'' |- ! style="color:green" | Fruits ! style="color:red" | Gras |- |Orange |Beurre |- |Poire |Tarte |- |Pomme |Crème glacée |}	Compléments nutritionels Fruits Gras Orange Beurre Poire Tarte Pomme Crème glacée

Largeur de bordure

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

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

Si border-width: a plus d'une valeur, les quatre nombres sont respectivement pour top (haut), right (droite), bottom (bas), left (gauche) (RAPPELEZ-vous que c'est l'ordre des aiguilles d'une montre ↑→↓←).

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

Lorsqu'il y a moins de quatre valeurs :

• trois valeurs soit top, right, bottom : alors la valeur par défaut de left est celle de right (seconde valeur). La largeur est alors la même à gauche qu'à droite.
• deux valeurs soit top, right : alors la valeur par défaut de bottom est celle de top (première valeur), et left par défaut reçoit la valeur de right (seconde valeur). La largeur est alors la même en haut qu'en bas; la largeur à gauche est la même que celle de droite.
• une valeur soit top : alors la valeur par défaut de right est celle de top de même pour bottom et left. Les quatre largeurs sont les mêmes et forment un contour régulier. Ce format est un raccourci d'écriture.

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 entrez	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 est le pixel par défaut. Ils sont également non valides dans HTML5.

Le « cellpadding » permet de régler l'espace qui entoure le contenu de la cellule jusqu'aux côtés.

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

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

Vous entrez	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

Padding

C'est la marge interne autour du contenu et du bord de la cellule.

Vous tapez	Ce que vous obtenez
{|class=wikitable | style="padding: 10px" | Exemple de style="padding:10px" |- | style="padding: 50px" | Exemple de style="padding:50px"<br/><br/>Spécifiez le remplissage sur '''chaque cellule''' |- | style="padding:100px" | Exemple de style="padding:100px" |}	Exemple de style="padding:10px" Exemple de style="padding:50px" Spécifiez le remplissage sur chaque cellule Exemple de style="padding:100px"

Largeur de colonne

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

Vous entrez :

{| class="wikitable" style="width: 85%;"
| colspan="2" | Cette largeur de colonne occupe 85 % de la largeur de l'écran
|-
| style="width: 30%"| '''Cette colonne est comptée à 30 % à partir de 85 % de la largeur de l'écran'''.
| style="width: 70%"| '''Cette colonne est comptée à 70 % à partir de 85 % de la largeur de l'écran'''
|}

Vous obtenez :

Cette largeur de colonne est à 85 % de la largeur de l'écran
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

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

Les cellules d'entê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 dans la même colonne). Lorsque le tableau est rendu dans un environnement visuel 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 attribut scope=row ou scope=col sur les cellules d'entête de tableau. Dans la plupart des cas avec des tableaux simples, vous utiliserez scope=col sur toutes les cellules d'entête de la première ligne, et scope=row sur la première cellule des lignes suivantes :

Vous entrez	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 les 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éfini comme auto. Pour avoir un tableau aligné au centre, vous devez définir les deux marges à auto.

Par exemple, un tableau aligné à droite :

Vous entrez

Vous obtenez

{| class="wikitable" style="margin-left: auto; margin-right: 0px;" | 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.

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.

Et un tableau aligné au centre :

Vous entrez	Vous obtenez
{| class="wikitable" style="margin: auto;" | 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.	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.

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 d'être aligné simplement. Cela peut être réalisé en utilisant l'attribut CSS float, qui peut spécifier le côté où le tableau est flottant, soit 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 qui l'entoure.

Vous entrez

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 des cellules

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

Vous entrez

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é du signe moins (ou un paramètre qui équivaut à un nombre négatif), votre tableau peut devenir corrompu car les caractères |- seront analysés comme étant du balisage wiki pour la ligne du tableau, et pas pour une cellule de tableau. Pour éviter cela, insérez une espace avant la valeur (| -6) ou utilisez le balisage de cellule en ligne (|| -6).

CSS avec 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 (entête ou données) du tableau sont rendues dans un seul groupe de lignes implicites (élément HTML ‎<tbody>‎</tbody>) sans aucun attribut ni style.

Tableaux et l'éditeur visuel (Visual Editor)

Voir aussi : Aide:Éditeur visuel/Guide utilisateur

Voir Phab: T108245: "Fully support basic table editing in the visual editor". Voir la liste des tâches. Les tâches terminées sont rayées. Il peut être difficile de comprendre, à partir du langage technique, ce qui a été amélioré ou quelles fonctionnalités ont été ajoutées. Veuillez ajouter des informations explicatives en-dessous.

Déplacer ou supprimer des colonnes ou des lignes

Cliquez sur un entête de colonne ou de ligne. Puis cliquez sur la flèche. Dans le menu contextuel, cliquez sur "Déplacer" ou "Supprimer".

Insérer une ligne ou une colonne vide

Dans le même menu contextuel, cliquez sur "Insérer".

Copier le tableau d'une page web vers Visual Editor

Il est possible de copier et coller un tableau à partir d'une page Web directement dans l'éditeur visuel (Visual Editor). Pour le faire en toute sécurité, utilisez le bac à sable et vérifiez que le tableau est correctement codé en mode source wikitext et correctement affiché dans Visual Editor et en mode de prévisualisation.

Outils d'aide

• Excel2Wiki vous permet de copier des tableaux Excel, Apache OpenOffice, LibreOffice, ou Gnumeric et les convertir en tableau wikicode.

Voir aussi

• Trier les lignes d'un tableau
• m:Help:Sorting
• w:Help:Tables
• Outil graphique pour générer des tableaux