Aide:Tableau

De Les Archives de Vault-Tec
Révision datée du 5 novembre 2021 à 16:07 par Kharmitch (discussion | contributions)
(diff) ◂ Version précédente | Voir la version actuelle (diff) | Version suivante ▸ (diff)

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.

Résumé des marqueurs de tableau Wiki[modifier le wikicode]

{| 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.

Généralités[modifier le wikicode]

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

En-têtes de tableau[modifier le wikicode]

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

Titre[modifier le wikicode]

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

class="va-table"[modifier le wikicode]

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

colspan et rowspan en HTML[modifier le wikicode]

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

Attributs HTML[modifier le wikicode]

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[modifier le wikicode]

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

Attributs dans les cellules[modifier le wikicode]

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

Attributs des lignes[modifier le wikicode]

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

Largeur de colonne[modifier le wikicode]

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

Alignement[modifier le wikicode]

Alignement de tableau[modifier le wikicode]

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

Tableau flottant autour du texte[modifier le wikicode]

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.

Alignement du contenu des cellules[modifier le wikicode]

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
|}
A B C
D E F
G H I

Avertissements[modifier le wikicode]

Nombres négatifs[modifier le wikicode]

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).

CSS vs attributs[modifier le wikicode]

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]

Classes de tableau[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;

Classes de rangée[modifier le wikicode]

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;