<dl>

A definition list is a list of items and their corresponding definitions.

A definition list is typically rendered in the following way:

  • The definition term is located against the starting margin of the page or column.
  • The definition description is indented. It is located either on the same line as the definition term, or it is placed on the next line.
  • The optional header content is located on a line before the definition list entries.

( <data> | <sort-as> )*, <dlhead> ?, <dlentry> +

Contained by

<abstract> , <body> , <bodydiv> , <dd> , <desc> , <div> , <draft-comment> , <entry> , <example> , <fallback> , <fig> , <figgroup> , <fn> , <li> , <linkinfo> , <lq> , <note> , <p> , <section> , <stentry>

In order
  1. Zero or more of the following
  2. Optional <dlhead>
  3. One or more <dlentry>

Contained by

- topic/dl

The <dl> element is a base element type. It is defined in the topic module.

The following attributes are available on this element: universal attributes and @compact.

The following attributes are available on this element: universal attributes and the attributes defined below.

Specifies whether the vertical spacing between list items is tightened. The following values are valid: yes, no, and -dita-use-conref-target. Some DITA processors or output formats might not support the @compact attribute.

Example

This section is non-normative.

The following code sample shows how a definition list can be used to describe the message levels that are generated by a monitoring application. The @compact attribute instructs processors to tighten the vertical spacing.

<dl compact="yes">
  <dlentry>
    <dt>Warning</dt>
    <dd>Problems were detected, but the software will continue to monitor activity.</dd>
  </dlentry>
  <dlentry>
    <dt>Error</dt>
    <dd>Problems were detected, and the software is in danger of shutting down.</dd>
  </dlentry>
  <dlentry>
    <dt>Severe</dt>
    <dd>Monitoring activity has ceased.</dd>
  </dlentry>
</dl>