Aide:Tableaux

From Gramps
Revision as of 09:36, 1 June 2009 by Romjerome (talk | contribs) (Table with TH headings)
Jump to: navigation, search

Les tableaux peuvent être inclus dans des pages wiki pages soit en utilisant les éléments tableaux HTML directement, soit en utilisant le format wiki pour définir un tableau. Les éléments du tableau HTML et leur utilisation sont bien décrit sur les différentes pages internet et ne sera pas discuté ici. Le bénéfice du code wiki étant que les tableaux sont une construction de symboles qui rendent la perception de la structure de ce dernier plus accessible qu'avec les éléments HTML.

La règle générale est que l'on évite les tableaux tant que l'on n'a pas besoins d'eux. La balise du tableau complique souvent l'édition de la page page.

Résumé des marqueurs de table Wiki

{| début de table
|+ descriptif du contenu, optionnel; un seul par table positionné entre le début de la table 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 de donnée , requis! Les cellules de données consécutives d'une table 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 table
  • Les marqueurs ci-dessus sont sur des ligne 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 table, 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 tables et de lignes ({| et |-) ne sont à 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 marquer de table ou de ligne, le parseur va supprimer celui-ci et le dernier attribut si 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.

Tableau simple

Brute

La table suivante manque de bordure, d'espacement correct mais montre la structure de table wiki la plus simple possible

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

Alternative

Pour un look plus table, les marqueurs de cellule peuvent être sur le même ligne séparé par des ||. Ce n'est pas très approprié pour les contenus de cellule plutôt long comme des paragraphes. Cela marche mieux pour des contenus courts, comme dans notre exemple.

Des espaces supplémentaires peuvent être ajoutés autour des marqueurs, comme dans l'exemple ci-dessous, pour rendre la syntaxe wiki plus lisible mais cela n'affecte en rien le rendu de la table.

Des attributs HTML peuvent être ajoutés (voir d'autres exemple de cette page) mais n'ont pas été mis sur l'exemple suivant pour simplifier.

Orange Pomme autre
Pain Tarte autre
Beurre Crème glacée et plus
{|
|  Orange    ||   Pomme      ||   autre
|-
|   Pain     ||   Tarte      ||   autre
|-
|   Beurre   || Crème glacée ||  et plus
|}

Avec attributs HTML

Vous pouvez ajouter des attributs HTML pour améliorer le rendu visuel

border="1"

Orange Pomme
Pain Tarte
Beurre Crème glacée
{| border="1"
|Orange
|Pomme
|-
|Pain
|Tarte
|-
|Beurre
|Crème glacée 
|}

align="center" border="1"

Au niveau d'une table, l'attribut "align" concerne l'alignement de la table dans la page, et non pas l'alignement des cellules de la table.

Orange Pomme
Pain Tarte
Beurre Crème glacée
{| align="center" border="1"
|Orange
|Pomme
|-
|Pain
|Tarte
|-
|Beurre
|Crème glacée
|}

align="right" border="1"

Les attributs peuvent être mis au niveau cellule. Par exemple, les nombres sont plus lisibles si ils sont allgnés à droite.

Orange Pomme 12,333.00
Pain Tarte 500.00
Beurre Crème glacée 1.00
{| border="1"
|Orange
|Pomme
|align="right"|12,333.00
|-
|Pain
|Tarte
|align="right"|500.00
|-
|Beurre
|Crème glacée
|align="right"|1.00
|}


Les attributs peuvent aussi être positionnés au niveau ligne

Orange Pomme 12,333.00
Pain Tarte 500.00
Beurre Crème glacée 1.00
{| border="1"
|Orange
|Pomme
|align="right"|12,333.00
|-
|Pain
|Tarte
|align="right"|500.00
|- style="font-style:italic;color:green;"
|Beurre
|Crème glacée
|align="right"|1.00
|}

cellspacing="0" border="1"

Orange Pomme
Pain Tarte
Beurre Crème glacée
{| cellspacing="0" border="1"
|Orange
|Pomme
|-
|Pain
|Tarte
|-
|Beurre
|Crème glacée 
|}

cellpadding="20" cellspacing="0" border="1"

Orange Pomme
Pain Tarte
Beurre Crème glacée
{| cellpadding="20" cellspacing="0" border="1"
|Orange
|Pomme
|-
|Pain
|Tarte
|-
|Beurre
|Crème glacée 
|}

Attributs HTML et attributs de style CSS

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

style="color:green;background-color:#ffffcc;" cellpadding="20" cellspacing="0" border="1"

Orange Pomme
Pain Tarte
Beurre Crème glacée
{| style="color:green;background-color:#ffffcc;" cellpadding="20" cellspacing="0" border="1"
|Orange
|Pomme
|-
|Pain
|Tarte
|-
|Beurre
|Crème glacée 
|}

Tableau avec entête TH

TH (HTML Table Headings = entête de table HTML) peuvent être insérés en utilisant ! au lieu de |. Par défaut les entêtes sont en gras et centrées.

Titre

Titre de colonne

Délicieux Excellent
Orange Pomme
Pain Tarte
Beurre Crème glacée
{| border="1" cellpadding="20" cellspacing="0"
!Délicieux
!Excellent
|-
|Orange
|Pomme
|-
|Pain
|Tarte
|-
|Beurre
|Crème glacée 
|}

Colspan="2"

Délices
Orange Pomme
Pain Tarte
Beurre Crème glacée
{| border="1" cellpadding="20" cellspacing="0"
! colspan="2"|Délices
|-
|Orange
|Pomme
|-
|Pain
|Tarte
|-
|Beurre
|Crème glacée 
|}

Titre de ligne

Défaut

Fruit Orange Pomme
Plat Pain Tarte
Accompagnement Beurre Crème glacée
{| border="1" cellpadding="20" cellspacing="0"
!Fruit
|Orange
|Pomme
|-
!Plat
|Pain
|Tarte
|-
!Accompagnement
|Beurre
|Crème glacée 
|}

Alignement à droite

L'alignement à droite des titres de ligne peut être réalisé comme suit

Fruit Orange Pomme
Plat Pain Tarte
Accompagnement Beurre Crème glacée
{| border="1" cellpadding="20" cellspacing="0"
!align="right" |Fruit
|Orange
|Pomme
|-
!align="right" |Plat
|Pain
|Tarte
|-
!align="right" |Accompagnement
|Beurre
|Crème glacée 
|}

Caption

A table caption can be added to the top of any table as follows

Food complements
Orange Apple
Bread Pie
Butter Ice cream
{| border="1" cellpadding="20" cellspacing="0"
|+Food complements
|-
|Orange
|Apple
|-
|Bread
|Pie
|-
|Butter
|Ice cream 
|}

Attributes can be added to the caption as follows

Food complements
Orange Apple
Bread Pie
Butter Ice cream
{| border="1" cellpadding="20" cellspacing="0"
|+align="bottom" style="color:#e76700;"|''Food complements''
|-
|Orange
|Apple
|-
|Bread
|Pie
|-
|Butter
|Ice cream 
|}

Table with H1, H2, H3 etc. headings

HTML H1, H2, H3, H4 etc. headings can be created the standard wiki markup way with ==equal== signs and must be on a line all by themselves to work.

Preview the whole table. If you click on an edit tab for a heading within a table, edit, and preview, the parent table will display erroneously broken because part of it will be missing.

Keep the heading hierarchy consistent with the rest of the page so that the table of contents at page top works correctly.

Yummiest

Orange Apple
Bread Pie
Butter Ice cream
{| border="1" cellpadding="20" cellspacing="0"
|colspan="2"|
===Yummiest===
|-
|Orange
|Apple
|-
|Bread
|Pie
|-
|Butter
|Ice cream 
|}

Lien externe

MediaWiki