L’élément table

Introduction à DITA Leçon 5 : Tableaux L’élément table
Progression de la Leçon
0% Terminé

Les tableaux DITA (<table>) utilisent les éléments suivants pour représenter et organiser les données tabulaires :

Élément Description Quantité
<title> Contient le titre du tableau. Zéro ou un.
<tgroup> Contient les spécifications de colonnes, les lignes d’en-tête et les lignes de corps. Chaque tableau contient au moins un élément <tgroup>.
<colspec> Définit la largeur des colonnes et les informations d’identification. Il devrait y avoir un élément <colspec> par colonne dans votre tableau.
<thead> Contient les lignes d’en-tête du tableau. Un <tgroup> peut contenir, au plus, un élément <thead>.
<tbody> Contient les lignes du corps du tableau. un <tgroup> doit avoir un et seulement un élément <tbody>.
<row> Contient une seule ligne du tableau. Un élément <thead> ou <tbody> peuvent contenir un nombre quelconque d’éléments <row>.
<entry> Contient les données d’une cellule du tableau. Peut contenir du texte ou d’autres éléments de bloc ou intégrés. Un élément <row> peut avoir un ou plusieurs éléments <entry>.

Voici un exemple d’une structure minimale d’un tableau DITA (une ligne d’en-tête, une ligne de corps, et trois colonnes). Notez que dans ce cas, le <tgroup> spécifie uniquement l’attribut cols, qui est requis :

 <table>
      <tgroup cols="3">
        <thead>
          <row>
            <entry>colonne 1, ligne d'en-tête</entry>
            <entry>colonne 2, ligne d'en-tête</entry>
            <entry>colonne 3, ligne d'en-tête</entry>
          </row>
        </thead>
        <tbody>
          <row>
            <entry>colonne 1, ligne de corps</entry>
            <entry>colonne 2, ligne de corps</entry>
            <entry>colonne 3, ligne de corps</entry>
          </row>
        </tbody>
      </tgroup>
    </table>
Le résultat ressemble à ceci :

Voici un tableau plus complexe :

 <table>
        <title>Mon premier tableau</title>
        <tgroup cols="2">
          <colspec colname="c1" colnum="1" colwidth="1*"/>
          <colspec colname="c2" colnum="2" colwidth="4*"/>
          <thead>
            <row>
              <entry>ligne d'en-tête, colonne 1</entry>
              <entry>ligne d'en-tête, colonne 2</entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry>ligne 1, colonne 1</entry>
              <entry>ligne 1, colonne 2</entry>
            </row>
            <row>
              <entry namest="c1" nameend="c2">Cette cellule s'étend sur deux colonnes.</entry>
            </row>
            <row>
              <entry morerows="1">Cette cellule s'étend sur deux lignes.</entry>
              <entry>ligne 3, colonne 2</entry>
            </row>
            <row>
              <entry>ligne 4, colonne 2</entry>
            </row>
          </tbody>
        </tgroup>
      </table>

ce qui donne :

Quelques notes sur le tableau :

  • L’élément <colspec> utilise des attributs pour spécifier les noms de colonne (colname), les numéros (colnum) et les largeurs (colwidth). Dans cet exemple, les colonnes ont des largeurs de « 1* » et « 4* ». L’astérisque indique que les paramètres sont proportionnels. La première colonne s’étend donc sur 20% de la largeur disponible et la deuxième colonne, 80%.
  • Chaque ligne a un élément <row> avec des éléments <entry> pour chaque cellule.
  • Notez que la ligne 2 a seulement un seul <entry>. C’est parce que l’entrée s’étend sur les deux colonnes, ce qui est spécifié avec les attributs name-start (namest) et name-end (nameend).
  • À la ligne 3, la première entrée couvre les lignes 3 et 4, vous avez donc un attribut morerows.

Le moyen le plus simple et le moins stressant de configurer correctement le code du tableau consiste à utiliser un éditeur qui gère ces paramètres pour vous. Coder manuellement les tableaux n’est pas pour les âmes sensibles.

Tableau 1. Mon premier tableau
ligne d’en-tête, colonne 1 ligne d’en-tête, colonne 2
ligne 1, colonne 1 ligne 1, colonne 2
Cette cellule s’étend sur deux colonnes.
Cette cellule s’étend sur deux lignes. ligne 3, colonne 2
ligne 4, colonne 2

Contributeurs
Chapitre précédent
Retour à la Leçon
Chapitre suivant