8.8. simpletable

L'élément <simpletable> est utilisé pour les tableaux de structure régulière et n'ayant pas besoin d'une légende. Choisissez l'élément de tableau simple pour présenter des données en rangées et colonnes régulières. Par exemple, les tableaux à colonnes multiples tels que les listes d'annuaire téléphonique sont de bons candidats pour l'élément <simpletable>. Une autre emploi judicieux de <simpletable> qui semble appeler une « liste de définition en trois parties » est de simplement utiliser l'attribut keycol pour indiquer quel colonne représente la « clé » ou la colonne de type rubrique de votre structure.

Cette correspondance étroite de la table simple et des données tabulaires régulières en fait un élément approprié comme base de structures spécialisées telles que l'élément <properties> (pour des informations de programmation) et l'élément <choicetable> (pour les tâches).

Exemple

Source :
<simpletable>
 <sthead>
  <stentry>Type style</stentry>
  <stentry>Elements used</stentry>
 </sthead>
 <strow>
  <stentry>Bold</stentry>
  <stentry>b</stentry>
 </strow>
 <strow>
  <stentry>Italic</stentry>
  <stentry>i</stentry>
 </strow>
 <strow>
  <stentry>Underlined</stentry>
  <stentry>u</stentry>
 </strow>
</simpletable>
Sortie formatée :
Type style Elements used
Bold b
Italic i
Underlined u

Contient :

Doctype Modèle de contenu
ditabase, topic, task, reference, concept, glossary, map, bookmap ( ( sthead) (optionnel) puis ( strow) (un ou plus) )

Contenu par :

Doctype Parents
ditabase p, note, lq, li, itemgroup, dd, fig, draft-comment, abstract, body, section, example, conbody, prereq, context, info, tutorialinfo, stepxmp, choice, stepresult, result, postreq, refbody, refsyn, glossdef, pd
topic p, note, lq, li, itemgroup, dd, fig, draft-comment, abstract, body, section, example, pd
task p, note, lq, li, itemgroup, dd, fig, draft-comment, abstract, body, section, example, prereq, context, info, tutorialinfo, stepxmp, choice, stepresult, result, postreq, pd
concept p, note, lq, li, itemgroup, dd, fig, draft-comment, abstract, body, section, example, conbody, pd
reference p, note, lq, li, itemgroup, dd, fig, draft-comment, abstract, body, section, example, refbody, refsyn, pd
map, bookmap p, note, lq, li, itemgroup, dd, fig, draft-comment

Héritage :

- topic/simpletable

Attributs :

Nom Description Type de donnée Valeur par défaut Obligatoire ?
relcolwidth Une valeur relative pour indiquer la largeur d'une colonne en relation avec celle des autres colonnes. Les valeurs sont totalisées puis transformées en pourcentages. Par exemple :

relcolwidth="1* 2* 3*"

donne des largeurs de 16.7 %, 33.3 %, et 66.7 %.

relcolwidth="90* 150*"

donne des largeurs de 37.5 % et 62.5 %.
CDATA #IMPLIED non
keycol Définit la colonne qui sera utilisée pour les rubriques de rangée. L'absence de valeur indique aucune clé de colonne. Si présente, la valeur numérique met en exergue la colonne spécifiée comme une rubrique verticale. NMTOKEN #IMPLIED non
refcols Désigne les colonnes qui contiennent des références et qui sont candidates pour une liaison automatique. Les colonnes sont identifiées par une liste de nombres séparés par des espaces (par exemple : 1 3). NMTOKENS #IMPLIED non
spectitle L'attribut de titre spécialisé permet aux architectes de types spécialisés de définir un titre fixe ou par défaut pour un élément spécialisé. Non prévu pour une utilisation directe par les auteurs. CDATA #IMPLIED non
%display-atts; (scale, frame, expanse) Un ensemble d'attributs liés, décrit à la section 25.1. %display-atts; entité paramètre sans objet pour une entité paramètre sans objet
%univ-atts; (%select-atts;, %id-atts;, %localization-atts;) Un ensemble d'attributs liés, décrit à la section 25.7. %univ-atts; entité paramètre sans objet pour une entité paramètre sans objet
%global-atts; (xtrf, xtrc) Un ensemble d'attributs liés, décrit à la section 25.2. %global-atts; entité paramètre sans objet pour une entité paramètre sans objet
class, outputclass Attributs communs, décrit à la section 25.9. Autres attributs DITA communs