The <ol>
HTML element represents an ordered list of items — typically rendered as a numbered list.
The <ol>
HTML element represents an ordered list of items — typically rendered as a numbered list.
This element also accepts the global attributes.
reversed
This Boolean attribute specifies that the list's items are in reverse order. Items will be numbered from high to low.
start
An integer to start counting from for the list items. Always an Arabic numeral (1, 2, 3, etc.), even when the numbering type
is letters or Roman numerals. For example, to start numbering elements from the letter "d" or the Roman numeral "iv," use start="4"
.
type
Sets the numbering type:
a
for lowercase lettersA
for uppercase lettersi
for lowercase Roman numeralsI
for uppercase Roman numerals1
for numbers (default)The specified type is used for the entire list unless a different type
attribute is used on an enclosed <li>
element.
Note: Unless the type of the list number matters (like legal or technical documents where items are referenced by their number/letter), use the CSS list-style-type
property instead.
Typically, ordered list items display with a preceding marker, such as a number or letter.
The <ol>
and <ul>
elements may nest as deeply as desired, alternating between <ol>
and <ul>
however you like.
The <ol>
and <ul>
elements both represent a list of items. The difference is with the <ol>
element, the order is meaningful. For example:
To determine which list to use, try changing the order of the list items; if the meaning changes, use the <ol>
element — otherwise you can use <ul>
.
html
<ol> <li>Fee</li> <li>Fi</li> <li>Fo</li> <li>Fum</li> </ol>
html
<ol type="i"> <li>Introduction</li> <li>List of Grievances</li> <li>Conclusion</li> </ol>
html
<p>Finishing places of contestants not in the winners' circle:</p> <ol start="4"> <li>Speedwalk Stu</li> <li>Saunterin' Sam</li> <li>Slowpoke Rodriguez</li> </ol>
html
<ol> <li>first item</li> <li> second item <!-- closing </li> tag is not here! --> <ol> <li>second item first subitem</li> <li>second item second subitem</li> <li>second item third subitem</li> </ol> </li> <!-- Here's the closing </li> tag --> <li>third item</li> </ol>
html
<ol> <li>first item</li> <li> second item <!-- closing </li> tag is not here! --> <ul> <li>second item first subitem</li> <li>second item second subitem</li> <li>second item third subitem</li> </ul> </li> <!-- Here's the closing </li> tag --> <li>third item</li> </ol>
Content categories | Flow content, and if the <ol> element's children include at least one <li> element, palpable content. |
---|---|
Permitted content | Zero or more <li> , <script> and <template> elements. |
Tag omission | None, both the starting and ending tag are mandatory. |
Permitted parents | Any element that accepts flow content. |
Implicit ARIA role | list |
Permitted ARIA roles | directory , group , listbox , menu , menubar , none , presentation , radiogroup , tablist , toolbar , tree |
DOM interface | HTMLOListElement |
Specification |
---|
HTML Standard # the-ol-element |
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
ol |
1 | 12 | 1 | Yes | 15 | ≤4 | 4.4 | 18 | 4 | 14 | ≤3.2 | 1.0 |
compact |
1 | 12 | 1 | Yes | 15 | 3 | 4.4 | 18 | 4 | 14 | 2 | 1.0 |
reversed |
18 | ≤79 | 18 | No | 15 | 6 | 4.4 | 18 | 18 | 14 | 6 | 1.0 |
start |
1 | 12 | 1 | Yes | 15 | ≤4 | 4.4 | 18 | 4 | 14 | ≤3.2 | 1.0 |
type |
1 | 12 | 1 | Yes | 15 | ≤4 | 4.4 | 18 | 4 | 14 | ≤3.2 | 1.0 |
<ul>
, <li>
, <menu>
<ol>
element: list-style
property, to choose the way the ordinal displaysline-height
property, to simulate the deprecated compact
attributemargin
property, to control the list indentation
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/HTML/Element/ol