Help:Tables/fr

From SME Server
Jump to navigationJump to search


Des tableaux peuvent être créés dans les pages wiki soit en utilisant la syntaxe des tableaux en HTML, soit en utilisant des marqueurs wiki pour définir le tableau. La syntaxe des tableaux en HTML et son utilisation sont expliquées sur nombre de pages web et ne seront pas expliquées ici. L'avantage des marqueurs wiki est que le tableau est construit en utilisant des caractères qui tendent à rendre plus perceptible la structure du tableau dans la vue d'édition par rapport à la syntaxe HTML.

Une bonne règle est toutefois d'éviter d'utiliser un tableau à moins d'en avoir vraiment l'usage. Leur utilisation complique souvent l'édition de page.

Résumé des marqueurs de tableau Wiki

{| début de tableau
|+ descriptif du contenu, optionnel; un seul par tableau positionné entre le début du tableau 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'un tableau 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 tableau
  • Les marqueurs ci-dessus sont sur des lignes 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 tableau, 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 tableaux 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 marqueur de table ou de ligne, le parseur va supprimer celui-ci et le dernier attribut s'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

Brut

Le tableau suivant manque de bordure, d'espacement correct mais montre la structure de tableau 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 tableau, les marqueurs de cellule peuvent être sur la même ligne, séparés par des ||. Ce n'est pas très approprié pour les contenus de cellule plutôt longs 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 du tableau.

Des attributs HTML peuvent être ajoutés (voir d'autres exemples 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'un tableau, l'attribut "align" concerne l'alignement du tableau dans la page, et non pas l'alignement des cellules du tableau.

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 tableau 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 
|}

Résumé

Un résumé peut être ajouté au dessus du tableau comme suit

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

Des Attributs peuvent être ajoutés au résumé

Compléments nutritionels
Orange Pomme
Pain Tarte
Beurre Crème glacée
{| border="1" cellpadding="20" cellspacing="0"
|+align="bottom" style="color:#e76700;"|''Compléments nutritionels''
|-
|Orange
|Pomme
|-
|Pain
|Tarte
|-
|Beurre
|Crème glacée 
|}

Tableau avec entête de type H1, H2, H3 etc.

Les types d'entête HTML H1, H2, H3, H4 etc. peuvent utilisés via les marqueurs wiki standards. Les signes ==égal== doivent être sur une même ligne pour être correctement interprétés.

Prévisualisez le tableau. Si vous cliquez sur la modification d'une entête située dans un tableau, l'édition et la prévisualisation apparaitront incorrectement tronquées parce qu'une partie manquera.

Garder la hiérarchie des entêtes consistante avec le reste de la page pour que la table des matières en haut de la page fonctionne correctement.

Les plus fameux

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