Des tableaux peuvent être créés sur ce wiki. Leur utilisation doit se limiter exclusivement à la présentation de données tabulaires. Ils ne doivent pas être utilisés pour organiser le contenu des articles. Voir la documentation Tableaux HTML : notions de base sur MDN Web Docs pour comprendre les raisons de cette limitation.
Sur les Archives de Vault-Tec, les tableaux sont utilisés pour présenter les données d'objets : armes, armures, consommables, composants, etc.
Notez que cette article est en majorité une reproduction de la page de documentation présente sur MediaWiki : Help:Tables/fr.
| {|
|
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 sur une nouvelles ligne 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 :
- suivre son marqueur de cellule sur la même ligne après les attributs HTML éventuels ;
- ou ê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.
Le tableau suivant manque de bordure, d'espacement correct mais montre la structure de tableau wiki la plus simple possible.
| wikitexte
|
rendu
|
{|
|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.
| wikitexte
|
rendu
|
{|
|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.
| wikitexte
|
rendu
|
{|
| Orange || Pomme || plus
|-
| Pain || Tarte || plus
|-
| Beurre || Crème glacée || et plus
|}
|
| Orange |
Pomme |
more
|
| Pain |
Tarte |
more
|
| Beurre |
Crème glacée |
and more
|
|
Vous pouvez aussi placer du texte plus long ou une syntaxe wiki plus complexe à l'intérieur des cellules du tableau :
| wikitexte
|
rendu
|
{|
|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
|
|
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.
Si vous voulez mettre des attributs comme dans l'élément d'en-tête, utilisez la barre verticale '|' comme séparateur. Et non pas le point d'exclamation « ! ».
| wikitexte
|
rendu
|
{|
! 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
|
|
Un titre de tableau peut être ajouté au sommet de n'importe quel tableau comme suit :
| wikitexte
|
rendu
|
{|
|+Compléments nutritionnels
|-
|Orange
|Pomme
|-
|Pain
|Tarte
|-
|Beurre
|Crème glacée
|}
|
Compléments nutritionnels
| Orange
|
Pomme
|
| Pain
|
Tarte
|
| Beurre
|
Crème glacée
|
|
La classe va-table doit être utilisé sur tous les tableaux présents pour appliquer le style du wiki.
| wikitexte
|
rendu
|
{| class="va-table"
|+Compléments nutritionels
|-
|Orange
|Pomme
|-
|Pain
|Tarte
|-
|Beurre
|Crème glacée
|}
|
Compléments nutritionels
| Orange
|
Pomme
|
| Pain
|
Tarte
|
| Beurre
|
Crème glacée
|
|
Vous pouvez utiliser les attributs HTML colspan et rowspan sur les cellules pour une mise en page avancée.
| wikitexte
|
rendu
|
{| class="va-table"
!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 des courses
|
| Pain et beurre
|
Tarte
|
brioches
|
Danois
|
Croissant
|
| Fromage
|
Crème glacée
|
Beurre
|
Yaourt
|
|
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.
En plaçant les attributs après la balise du début de tableau ({|) vous appliquez les attributs à la totalité du tableau.
| You type
|
You get
|
{| class="va-table" 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
|
|
Il est possible de mettre des attributs dans des cellules individuelles. Par exemple, les nombres peuvent sembler mieux s'ils sont alignés à droite.
| You type
|
You get
|
{| class="va-table"
| 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 des |.
| You type
|
You get
|
{| class="va-table"
| 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
|
|
Vous pouvez également mettre des attributs sur des lignes individuelles.
| wikitexte
|
rendu
|
{| class="va-table"
| 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[modifier le wikicode]
Les attributs peuvent être ajoutés au titre et aux entêtes comme suit.
| wikitexte
|
rendu
|
{| class="va-table"
|+ 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 nutritionnels
| Fruits
|
Gras
|
| Orange
|
Beurre
|
| Poire
|
Tarte
|
| Pomme
|
Crème glacée
|
|
La largeur de colonne peut être ajoutée comme suit.
Vous entrez :
{| class="va-table" 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 occupe 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[modifier le wikicode]
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 :
| wikitexte
|
rendu
|
{| class="va-table"
|-
! 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
|
|
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 :
| wikitexte
|
rendu
|
{| class="va-table" 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 :
| wikitexte
|
rendu
|
{| class="va-table" style="margin: auto;"
| Orange
| Pomme
|-
| Pain
| Tarte
|-
| Beurre
| Crème glacée
|}
|
| Orange
|
Pomme
|
| Pain
|
Tarte
|
| Beurre
|
Crème glacée
|
|
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.
| wikitexte
|
rendu
|
{| class="va-table" 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.
|
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.
| wikitexte
|
rendu
|
{| class="va-table"
|- 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
|}
|
|
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 étant du 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 cellule en ligne (|| -6).
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[modifier le wikicode]
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.
Tableau customisé des Archives de Vault-Tec[modifier le wikicode]
Seule la classe va-table est obligatoire. Les autres classes fournissent des fonctionnalités supplémentaires décrites ci-dessous.
| Type d'effet
|
Nom de la classe CSS
|
Effet
|
CSS correspondant
|
| Couleurs & formatage
|
va-table
|
La classe de base. Applique les couleurs et le formatage standard.
|
|
| Largeur du tableau
|
va-table-full
|
Le tableau occupera toute la largeur de la page. Il est conseillé d'utiliser cette classe plutôt que d'écrire directement « width: 100%; ».
|
width: 100%;
|
| va-table-full-infobox
|
Tableau qui possède une largeur utilisant le plus d'espace possible, tout en laissant un espace sur la droite pour l'infobox.
|
width: 960px;
|
| Alignement du tableau (float)
|
va-table-float-left
|
Le tableau est flottant sur la gauche (c'est à dire que le texte peut se placer sur la droite du tableau) et les marges standards sont appliquées.
|
clear: left; float: left; margin: 0 10px 10px 0;
|
| va-table-float-right
|
Le tableau est flottant sur la droite (c'est à dire que le texte peut se placer sur la gauche du tableau) et les marges standards sont appliquées.
|
clear: right; float: right; margin: 0 0 10px 10px;
|
Alignement du texte
dans les cellules (horizontal)
|
va-table-center
|
Le texte contenu dans les cellules (et non dans les en-têtes) est centré horizontalement.
|
text-align: center;
|
| va-table-center-col#
|
Le texte contenu dans les cellules de la colonne choisie est centré horizontalement. Par exemple, « va-table-center-col3 » centrera le texte des cellules de la 3e colonne.
|
text-align: center;
|
| va-table-left
|
Le texte des cellules est aligné sur la gauche.
|
text-align: left;
|
| va-table-left-col#
|
Le texte contenu dans les cellules de la colonne choisie est aligné sur la gauche. Par exemple, « va-table-left-col3 » alignera à gauche le texte des cellules de la 3e colonne.
|
text-align: left;
|
| va-table-right
|
Le texte des cellules est aligné sur la droite.
|
text-align: right;
|
| va-table-right-col#
|
Le texte contenu dans les cellules de la colonne choisie est aligné sur la droite. Par exemple, « va-table-left-col3 » alignera à droite le texte des cellules de la 3e colonne.
|
text-align: right;
|
Alignement du texte
dans les cellules (vertical)
|
va-table-bottom
|
Le texte des cellules est aligné avec le pied de la cellule.
|
vertical-align: bottom;
|
| va-table-middle
|
Le texte des cellules est aligné verticalement.
|
vertical-align: middle;
|
| va-table-top
|
Le texte des cellules est aligné avec la tête de la cellule.
|
vertical-align: top;
|
Ces classes peuvent être assignées à une rangée individuelle.
| Type d'effet
|
Nom de la classe CSS
|
Effet
|
CSS correspondant
|
| Couleurs & formatage
|
va-table-highlight
|
Marque la rangée du tableau avec un fond différent.
|
background-color: #1B1B1B;
|
