7.11. dl

Une liste de définition (<dl>) est une liste de termes et des définitions correspondantes. Le terme (<dt>) est habituellement justifié à gauche. La description ou définition (<dd>) est habituellement soit indentée et à la ligne suivante, soit sur la même ligne et à droite du terme.

On peut également fournir un titre (heading) optionnel aux termes et définitions avec l'élément <dlhead>, lequel contient des éléments d'en-tête pour ces colonnes. Le formatage par défaut de <dlhead> est celui d'un tableau avec une rangée de rubriques (heading row).

Exemples

Simple :

<dl>
<dlentry>
<dt>Bytes returned</dt>
<dd>The number of bytes of data returned.</dd>
</dlentry>
<dlentry>
<dt>Bytes available</dt>
<dd>The number of bytes of data available to be returned.</dd>
</dlentry>
<dlentry><dt>Handle</dt>
<dd>The returned handle value</dd>
</dlentry>
</dl>

Avec rubriques :

<dl>
 <dlhead>
  <dthd>Image File View Selection</dthd>
  <ddhd>Resulting Information</ddhd>
 </dlhead>
 <dlentry>
  <dt>File Type</dt>
  <dd>Image's file extension</dd>
 </dlentry>
 <dlentry>
  <dt>Image Class</dt>
  <dd>Image is raster, vector, metafile or 3D</dd>
 </dlentry>
 <dlentry>
  <dt>Number of pages</dt>
  <dd>Number of pages in the image</dd>
 </dlentry>
 <dlentry>
  <dt>Fonts</dt>
  <dd>Names of the fonts contained within a vector image</dd>
 </dlentry>
</dl>

Contient :

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

Contenu par :

Doctype Parents
ditabase desc, p, note, lq, li, itemgroup, dd, fig, stentry, draft-comment, fn, entry, abstract, body, section, example, linkinfo, conbody, prereq, context, info, tutorialinfo, stepxmp, choice, choptionhd, chdeschd, choption, chdesc, stepresult, result, postreq, refsyn, proptypehd, propvaluehd, propdeschd, propdesc, glossdef, pd
topic desc, p, note, lq, li, itemgroup, dd, fig, stentry, draft-comment, fn, entry, abstract, body, section, example, linkinfo, pd
task desc, p, note, lq, li, itemgroup, dd, fig, stentry, draft-comment, fn, entry, abstract, body, section, example, linkinfo, prereq, context, info, tutorialinfo, stepxmp, choice, choptionhd, chdeschd, choption, chdesc, stepresult, result, postreq, pd
concept desc, p, note, lq, li, itemgroup, dd, fig, stentry, draft-comment, fn, entry, abstract, body, section, example, linkinfo, conbody, pd
reference desc, p, note, lq, li, itemgroup, dd, fig, stentry, draft-comment, fn, entry, abstract, body, section, example, linkinfo, refsyn, proptypehd, propvaluehd, propdeschd, propdesc, pd
map, bookmap desc, p, note, lq, li, itemgroup, dd, fig, stentry, draft-comment, fn, entry

Héritage :

- topic/dl

Attributs :

Nom Description Type de donnée Valeur par défaut Obligatoire ?
compact Indique un espacement vertical serré entre les éléments de la liste. Par défaut, l'espacement est étendu. Le résultat en sortie d'un espacement compact dépend du processeur ou du navigateur. Les valeurs permises sont :
yes
Indique un espacement compact.
no
Indique un espacement étendu.
-dita-use-conref-target
Cf. la section 25.10.1.1. Utilisation de la valeur "-dita-use-conref-target" pour plus d'informations.
(yes | no | -dita-use-conref-target) #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
%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