This section is normative.
As its name suggests, the List Module provides list-oriented elements. Specifically, the List Module supports the following elements and attributes:
|dl||Common||title?, caption?, (( dt | dd)+ | di+)|
|di||Common||( dt+, dd*)|
|caption , title?,||Common||( Text)*|
|ul||Common||title?, caption?, li+|
|li||Common, @value||( Flow)*|
This module also defines the content set List with the content model (dl | ol | ul)+ and adds this set to the Structural content set of the Structural Module.
Implementations: RELAX NG, XML Schema
XHTML offers authors several mechanisms for specifying lists of information. Lists may contain:
The previous list, for example, is an unordered list, created with the ul element:
<ul> <li>Unordered information. </li> <li>Ordered information. </li> <li>Definitions. </li> </ul>
An ordered list, created using the ol element, contains information where order is important, as in a recipe:
Definition lists, created using the dl element, generally consist of a series of term/definition pairs (although definition lists may have other applications). Thus, when advertising a product, one might use a definition list:
defined in XHTML as:
<dl> <dt>Lower cost</dt> <dd>The new version of this product costs significantly less than the previous one!</dd> <dt>Easier to use</dt> <dd>We've changed the product so that it's much easier to use!</dd> <dt>Safe for kids</dt> <dd>You can leave your kids alone in a room with this product and they won't get hurt (not a guarantee).</dd> </dl>
Definition lists vary only slightly from other types of lists in that list items consist of two parts: a term and a description. The term is given by the dt element. The description is given with a dd element. The term and its definition can be grouped within a di element to help clarify the relationship between a term and its definition(s).
<dl> <di> <dt>Dweeb</dt> <dd>young excitable person who may mature into a <em>Nerd</em> or <em>Geek</em></dd> </di> <di> <dt>Hacker</dt> <dd>a clever programmer</dd> </di> <di> <dt>Nerd</dt> <dd>technically bright but socially inept person</dd> </di> </dl>
Here is an example with multiple terms and descriptions:
<dl> <dt>Center</dt> <dt>Centre</dt> <dd> A point equidistant from all points on the surface of a sphere.</dd> <dd> In some field sports, the player who holds the middle position on the field, court, or forward line.</dd> </dl>
Both types of lists are made up of sequences of list items defined by the li element. The difference is that ol lists represent lists of items that are essentially ordered (such as the steps of a recipe), while ul lists represent lists of items that are essentially unordered (such as shopping lists).
Basic list structure
<ol> <li>Spring</li> <li>Summer</li> <li>Autumn</li> <li>Winter</li> </ol>
The li element defines a list item within an ordered, unordered, or navigation list.
Within a list, each
li element has an associated number, which is used for numbering list items in ordered lists:
lielement has a
valueattribute, the associated number is the value of that attribute;
lielement is the first in the list, then the number has the value 1;
liin the same list.