Vous pouvez contribuer simplement à Wikibéral. Pour cela, demander un compte à admin@liberaux.org. N'hésitez pas!



Aide:Guide d'utilisation des tableaux

De Wikiberal

Les tableaux peuvent être très utiles pour la représentation de certaines données sur Wikibéral. Si vous êtes déjà familier des codes HTML permettant de créer des tableaux, vous pouvez insérer simplement le code directement dans l'article que vous êtes en train d'éditer.

Cependant, les balises de tableaux sont parfois difficiles à éditer surtout pour quelqu'un n'étant pas à l'aise avec la codification HTML. Pour cela, des nouvelles balises développées par Magnus Manske ont été créées. Ces balises remplacent les traditionnelles balises HTML <table>, <tr>, <td>, <th> et <caption>. On peut donc se passer totalement des balises HTML, il est même plutôt conseillé de ne plus utiliser de code HTML pour créer un tableau malgré le fait que son utilisation soit encore possible.

L'utilisation de tableaux doit être évitée si cela est possible. En effet, l'accessibilité aux pages qui contiennent un tableau est rendue plus difficile à certaines personnes, notamment aux aveugles.

Tout au long de cette page d'aide, nous donnerons toujours le codage Wiki et le codage HTML pour chacun des tableaux que nous montrerons.

Petits exemples

Nous montrerons, ici, deux exemples simples pour avoir un premier contact avec le codage Wiki. Notre premier exemple nous montrera le tableau le plus minimaliste qui soit, c'est à dire celui qui ne contiendrait qu'une seule cellule.

Résultat affiché Codage Wiki Codage HTML
cellule
{| border="1"
|cellule
|}
<table border="1">
  <tr>
    <td>cellule</td>
  </tr>
</table>


Le deuxième exemple contient deux cellules. Comme vous pouvez le constater, il est possible de disposer les cellules de deux façons différentes. Soit les cellules sont placées les unes en dessous des autres, soit elles sont placées les unes à côté des autres. Mais nous y reviendrons plus en détail par la suite.

Résultat affiché Codage Wiki Codage HTML
gauche droite
{| border="1"
|gauche
|droite
|}
<table border="1">
  <tr>
    <td>gauche</td>
    <td>droite</td>
  </tr>
</table>
gauche droite
{| border="1"
|gauche || droite
|}
<table border="1">
  <tr>
    <td>gauche</td>
    <td>droite</td>
  </tr>
</table>

La syntaxe des tableaux

Nous verrons ici les différentes balises qui peuvent apparaître dans la création d'un tableau.


table

Dans le langage HTML, l'élément table est l'élément de base pour la création d'un tableau. En wiki, pour créer un tableau, nous procédons de la façon suivante :

{| paramètres
 |}

ce qui donnerait en HTML, l'encodage suivant :

<table paramètres>
</table>

On voit donc bien qu'un tableau commence toujours par l'accolade ouvrante {, suivie d'un trait vertical |. La fin d'un tableau est également composée de deux caractères. Le premier est le trait vertical | et il est suivi du deuxième caractère qui est l'accolade fermante }. Le champ paramètres doit bien entendu être remplacé par différents paramètres utilisés dans les tableaux tel que la couleur de fond, la taille, s'il faut faire apparaître une bordure, etc. L'utilisation des paramètres n'est pas obligatoire et on peut donc sans problème ne rien placer à cet endroit.

td

En HTML, l'élément td représente une cellule dans une ligne du tableau. Pour créer des cellules, la syntaxe est la suivante :

|cellule1
|cellule2
|cellule3

Une autre disposition des cellules totalement équivalente est la suivante :

|cellule1||cellule2||cellule3

Cette deuxième disposition impose qu'entre deux cellules apparaissent deux traits verticaux || car un seul trait sera interpreté différemment par le logiciel. Mais ces deux dispositions donnent le même code en HTML qui est le suivant :

<td>cellule1</td><td>cellule2</td><td>cellule3</td>


Comme pour le tableau en lui-même, chacune des cellules d'un tableau peut contenir des paramètres. Pour cela, le contenu d'une cellule sera précédé des paramètres de la façon suivante :

|paramètres|cellule1
|paramètres|cellule2
|paramètres|cellule3

ou encore, suivant l'autre disposition :

|paramètres|cellule1||paramètres|cellule2||paramètres|cellule3

mais quelle que soit la disposition utilisée, le code HTML sera le suivant :

<td paramètres>cellule1</td><td paramètres>cellule2</td><td paramètres>cellule3</td>

tr

Ce sont les balises tr qui permettent de passer à une nouvelle ligne dans le tableau. Leur utilisation est très simple, lorsque vous souhaitez passer à une nouvelle ligne, il suffit de faire :

|-

et comme le nombre de tirets - n'a pas de limite maximale, on peut très bien utiliser :

|-----------------------------------------------------

et nous obtenons en HTML :

<tr> ... </tr>

Un grand avantage du codage wiki est qu'il se charge entièrement de la fermeture des balises tr ainsi que de leur ouverture si cette ouverture est nécessaire. Par exemple, si on reprend le tout premier tableau que nous avons créé, celui contenant une seule cellule, nous n'utilisons pas |- dans notre encodage et pourtant le code source HTML contient bien une balise tr.


Comme pour les autres balises, il est bien sûr possible d'utiliser des paramètres :

|- paramètres

ce qui donne en HTML :

<tr paramètres> ... </tr>

th

Les balises th sont très semblables aux balises td dans le sens où leur utilisation est totalement identique, seul la syntaxe change. Cependant il y a bien une différence notable entre ces deux balises qui intervient au niveau visuel. La balise th est généralement utilisée pour spécifier qu'une cellule représente un titre. Et elle peut, à cet effet, être utilisée partout où vous estimez que la cellule représente un titre. Visuellement, cela se voit car le texte de la cellule est en gras.

La syntaxe est différente et là où on utilisait un trait vertical pour les cellules, nous utiliserons un point d'exclamation !

!titre1
!titre2
!titre3

ou suivant l'autre disposition :

!titre1!!titre2!!titre3

par contre, entre les paramètres et le contenu de la cellule, nous utiliserons toujours le trait vertical |

!paramètres|titre1!!paramètres|titre2!!paramètres|titre3

et nous obtenons alors en HTML :

<th paramètres>titre1</th><th paramètres>titre2</th><th paramètres>titre3</th>

Voyons ce que nous obtenons sur un exemple. Si on souhaite que dans notre tableau, la première ligne soit interpretée comme étant une ligne de titres :

Résultat affiché Codage Wiki Codage HTML
Titre Colonne 1 Titre Colonne 2
cellule1 cellule2
{| border="1"
! Titre Colonne 1 !! Titre Colonne 2
|-
|cellule1
|cellule2
|}
<table border="1">
  <tr>
    <th>Titre Colonne 1</th>
    <th>Titre Colonne 2</th>
  </tr>
  <tr>
    <td>cellule1</td>
    <td>cellule2</td>
  </tr>
</table>

Dans l'exemple qui suit, bien que la cellule de la seconde colonne ne soit pas balisée comme un titre (nous utilisons les deux traits || au lieu de !!), le logiciel la considère malgré tout comme telle :

Résultat affiché Codage Wiki Codage HTML
Titre Colonne 1 Colonne 2
{| border="1"
! Titre Colonne 1 || Colonne 2
|}
<table border="1">
  <tr>
    <th>Titre Colonne 1</th>
    <th>Colonne 2</th>
  </tr>
</table>

Pour éviter ce problème, nous devons faire passer la deuxième colonne à la ligne comme ceci :

Résultat affiché Codage Wiki Codage HTML
Titre Colonne 1 Colonne 2
{| border="1"
! Titre Colonne 1
| Colonne 2
|}
<table border="1">
  <tr>
    <th>Titre Colonne 1</th>
    <td>Colonne 2</td>
  </tr>
</table>

caption

L'élément caption représente une légende. C'est un petit texte qui est placé au-dessus du tableau qui permet de préciser ce qui se trouve dans le tableau. Voici comment introduire une légende en Wiki :

|+ légende

qui donnera en HTML

<caption>légende</caption>

encore une fois, il est possible d'utiliser des paramètres de la façon suivante :

|+ paramètres|légende

qui donne alors

<caption paramètres>légende</caption>

Il n'est autorisé de placer qu'une seule légende par tableau. Cependant s'il en existe plusieurs, seule la première sera prise en compte. Voici le résultat que l'on obtient :

Résultat affiché Codage Wiki Codage HTML
légende
Colonne 1 Colonne 2
{| border="1"
|+ légende
| Colonne 1
| Colonne 2
|}
<table border="1">
  <caption>légende</caption>
  <tr>
    <td>Colonne 1</td>
    <td>Colonne 2</td>
  </tr>
</table>


Exemple récapitulatif

Maintenant que nous avons vu les différentes balises qui sont supportées par le codage Wiki, nous allons vous montrer un exemple récapitulatif dans lequel tout ce que nous venons de voir apparaîtra.

Résultat affiché Codage Wiki Codage HTML
légende
Titre 1 Titre 2
Titre ligne Cellule 1 Cellule 2
{| border="1"
|+ légende
!
! Titre 1 !! Titre 2
|-
! Titre ligne
| Cellule 1
| Cellule 2
|}
<table border="1">
  <caption>légende</caption>
  <tr>
    <th></th>
    <th>Titre 1</th>
    <th>Titre 2</th>
  </tr>
  <tr>
    <th>Titre ligne</th>
    <td>Cellule 1</td>
    <td>Cellule 2</td>
  </tr>
</table>

Tableaux imbriqués

Lorsque vous créez un tableau, vous pouvez y imbriquer un autre tableau. Au lieu de placer du texte dans une cellule, il suffit d'y placer un tableau comme le montre l'exemple suivant :

Résultat affiché Codage Wiki Codage HTML
Gauche
tableau imbriqué autre cellule
Droite
Cellule 1 Cellule 2 Cellule 3
{| border="1"
| Gauche
|
{| border="1"
|tableau imbriqué
|autre cellule
|}
| Droite
|-
| Cellule 1
| Cellule 2
| Cellule 3
|}
<table border="1">
  <tr>
    <td>Gauche</td>
    <td>
      <table border="1">
        <tr>
          <td>tableau imbriqué</td>
          <td>autre cellule</td>
        </tr>
      </table>
    </td>
    <td>Droite</td>
  </tr>
  <tr>
    <td>Cellule 1</td>
    <td>Cellule 2</td>
    <td>Cellule 3</td>
  </tr>
</table>


Problèmes éventuels