Ordered Lists (HTML & XHTML: The Definitive Guide, 4th Edition)

7.2.1. The <ol> Tag

The typical browser formats the contents of an ordered list just like an unordered list, except that the items are numbered instead of bulleted. The numbering starts at one and is incremented by one for each successive ordered list element tagged with <li>. Section 7.3, "The <li> Tag"

<ol>

Function:

Define an ordered list

Attributes:

CLASS
ONMOUSEDOWN

COMPACT
ONMOUSEMOVE

DIR
ONMOUSEOUT

ID
ONMOUSEOVER

LANG
ONMOUSEUP

ONCLICK
START

ONDBLCLICK
STYLE

ONKEYDOWN
TITLE

ONKEYPRESS
TYPE

ONKEYUP

End tag:

</ol>; never omitted

Contains:

list_content

Used in:

block

HTML 3.2 introduced a number of features that provide a wide variety of ordered lists. You can change the start value of the list and select any of five different numbering styles. Here is a sample XHTML ordered list:

<h3>Pickled Kumquats</h3>
Here's an easy way to make a delicious batch of pickled 'quats:
<ol>
  <li>Rinse 50 pounds of fresh kumquats</li>
  <li>Bring eight gallons white vinegar to rolling boil</li>
  <li>Add kumquats gradually, keeping vinegar boiling</li>
  <li>Boil for one hour, or until kumquats are tender</li>
  <li>Place in sealed jars and enjoy!</li>
</ol>

This is rendered by Netscape as shown in Figure 7-2.

Figure 7-2. An ordered list

7.2.1.1. The start attribute

Normally, browsers automatically number ordered list items beginning with the Arabic numeral 1. The start attribute for the <ol> tag lets you change that beginning value. To start numbering a list at 5, for example:

<ol start=5>
  <li> This is item number 5.</li>
  <li> This is number six!</li>
  <li> And so forth...</li>
</ol>

7.2.1.2. The type attribute

By default, browsers number ordered list items with a sequence of Arabic numerals. Besides being able to start the sequence at some number other than 1, you also can use the type attribute with the <ol> tag to change the numbering style itself. With the <ol> tag, the type attribute may have a value of A for numbering with capital letters, a for numbering with lowercase letters, I for capital Roman numerals, i for lowercase Roman numerals, or 1 for common Arabic numerals. (See Table 7-1.)

Table 7-1. HTML Type Values for Numbering Ordered Lists

Type Value	Generated Style	Sample Sequence
`A`	Capital letters	A, B, C, D
`a`	Lowercase letters	a, b, c, d
`I`	Capital Roman numerals	I, II, III, IV
`i`	Lowercase Roman numerals	i, ii, iii, iv
`1`	Arabic numerals	1, 2, 3, 4

The start and type attribute extensions work in tandem. The start attribute sets the starting value of the item integer counter at the beginning of an ordered list. The type attribute sets the actual numbering style. For example, the following ordered list starts numbering items at 8, but because the style of numbering is set to i, the first number is the lowercase Roman numeral "viii." Subsequent items are numbered with the same style, and each value is incremented by 1 as shown in this HTML example:[46]

[46]Notice that we don't include the </li> end tag in the HTML example, but do in all the XHTML ones? Some end tags are optional with HTML, but must be included in all XHTML documents.

<ol start=8 type="i">
  <li> This is the Roman number 8.
  <li> The numerals increment by 1.
  <li> And so forth...
</ol>

The results are shown in Figure 7-3.

7.2. Ordered Lists

7.2.1. The <ol> Tag

<ol>

Figure 7-2. An ordered list

7.2.1.1. The start attribute

7.2.1.2. The type attribute

Table 7-1. HTML Type Values for Numbering Ordered Lists

Figure 7-3. The start and type attributes work in tandem

7.2.1.3. Compact ordered lists

7.2.1.4. The class, dir, id, lang, event, style, and title attributes