<orderedlist> (
Ordered List)
Description
Description
This element contains a series of list items where each item is given a unique number so that it can be independently referenced from other text, or simply in order to indicate that the sequence of items is in some way significant. Various numbering techniques are available, including "arabic" (1, 2, 3, 4, 5) and "lower-case roman" (i, ii, iii, iv, v)):
<orderedlist>
<listitem><para>item one</para></listitem>
<listitem><para>item two</para></listitem>
<listitem><para>item three</para></listitem>
</orderedlist>
1) item one
2) item two
3) item three
There must be at least two lists items (a single item cannot form a sequence), unlike simple lists.
Parent Elements
The elements listed below may directly contain this element.
They are "parent" elements. Elements in referenced groups are included, up to two levels of group nesting.
Model Diagram
The DTD model for this element:
--+(sequence)
|
listtitle (optional) -- (TEXT and elements)
|
listitem (repeatable) -- (elements)
DTD Definition
The DTD contains the following element and attribute definitions
(note that embedded links are to definitions within the DTD page of this guide):
<!ELEMENT orderedlist (listtitle?, listitem+)>
<!ATTLIST orderedlist
numeration (arabic | upperalpha | loweralpha | upperroman |
lowerroman) #IMPLIED
continuation (continues | restarts) "restarts"
spacing (normal | compact) #IMPLIED
%a-group-CommonIDAttrs;>
.
Defined in DTD section
Block-level Content : Lists
General Attributes (shared with other elements)
Local Attributes (defined for this element alone)
Description
This attribute specifies the kind of numbering to use for the list items. The options are as follows:
| |
- |
"arabic" = arabic numeracls (1, 2, 3, 4, 5 ...) (this is the usual implied default value)
|
| |
- |
"upperalpha" = upper-case alphabetic (A, B, C, D, E ...)
|
| |
- |
"loweralpha" = lower-case alphabetic (a, b, c, d, e ...)
|
| |
- |
"upperroman" = upper-case roman numerals (I, II, III, IV, V ...)
|
| |
- |
"lowerroman" = lower-case roman numerals (i, ii, iii, iv, v ...)
|
Specification
This attribute is not required. The allowed values are "arabic", "upperalpha", "loweralpha", "upperroman" and "lowerroman".
DTD Definition
numeration (arabic | upperalpha | loweralpha | upperroman |
lowerroman) #IMPLIED .
Description
This attribute can be used to specify that the first item of the list "continues" a sequence started in a previous list, or "restarts" from "1" (or "A", "a", "I" or "i") (this being the default scenario).
Specification
This attribute is required but has a default value of "restarts". The allowed values are "continues" and "restarts".
DTD Definition
continuation (continues | restarts) "restarts"
.
Description
This attribute can be used to specify that the list items should be "compact" (instead of the implied default value of "normal"):
<orderedlist spacing="normal">
<listitem><para>Item One</para></listitem>
<listitem><para>Item Two</para></listitem>
<listitem><para>Item Three</para></listitem>
</orderedlist>
1) Item One
2) Item Two
3) Item Three
<orderedlist spacing="compact">
<listitem><para>Item One</para></listitem>
<listitem><para>Item Two</para></listitem>
<listitem><para>Item Three</para></listitem>
</orderedlist>
1) Item One
2) Item Two
3) Item Three
Specification
This attribute is not required. The allowed values are "normal" and "compact".
DTD Definition
spacing (normal | compact) #IMPLIED
.