<ol>

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Sumário

O Elemento HTML <ol> (ou Elemento HTML de lista ordenada) representa uma lista de itens ordenados. De forma característica esses itens ordenados em uma lista são mostrados com uma contagem que os precede, que pode ser de qualquer tipo, como numerais, letras, algarismos romanos, ou simples símbolos. Esse modelo numerado não é definido na descrição html da página, mas na folha de estilos CSS associada, pela propriedade list-style-type.

Não há limitação para a profundidade e a imbricação das listas definidas com os elementos <ol> e <ul>.

Nota: Ambos os elementos <ol> e <ul>, representam uma lista de itens. Diferem porque, com o elemento <ol>, a ordem é significativa. Como regra de ouro para determinar qual deles usar, tente mudar a ordem dos itens da lista; se a significação for alterada, o elemento <ol> deve ser utilizado, senão o elemento <ul> é adequado.

  • Categorias de conteúdoFlutuante e no caso dos elementos filhos de <ol> incluirem pelo menos um elemento de conteúdo <li> evidente.
  • Conteúdo permitido Zero ou mais elementos <li>
  • Omissão de etiqueta (Tag) Nenhuma, tanto a tag inicial quanto a final são obrigatórias.
  • Elementos pai permitidos Qualquer elemento que aceite conteúdo flutuante.
  • Interface DOM HTMLOListElement

Atributos

Este elemento inclui os atributos globais.

compact Deprecated

Este atributo boleano sugere que a lista deve ser renderizada em um estilo compacto. A interpretação deste atributo depende do perfil de navegação (user agent) e não funciona em todos os navegadores.

Nota: Não utilize este atributo, pois ele se tornou obsoleto. O elemento <ol> deve ser estilizado usando CSS. Para dar um efeito semelhante ao do atributo compacto, a propriedade CSS line-height pode ser utilizada com o valor de 80%.

reversed

Este atributo boleano especifica que as partes desta lista serão especificadas em ordem reversa, isto é, a menos importante será listada primeiro.

start

Este atributo inteiro especifica o valor inicial para a numeração dos itens da lista. Embora o tipo de ordenação dos elementos possa ser com algarismos romanos, tal como XXXI, ou letras, o valor inicial sempre é representado como um inteiro. Para iniciar a contagem a partir da letra "C", utilize <ol start="3">.

Nota: Este atributo, obsoleto na HTML4, foi reintroduzido na HTML5.

type

Indica o tipo de numeração:

  • 'a' indica letras minúsculas,
  • 'A' indica letras maiúsculas,
  • 'i' indica algarismos romanos minúsculos,
  • 'I' indica algarismos romanos maiúsculos,
  • e '1' indica números (padrão).

O tipo de marcação é usado na lista inteira, a menos que um atributo type diferente seja utilizado dentro do elemento <li>.

Nota: Este atributo, obsoleto na HTML4, foi reintroduzido na HTML5. A menos que o valor do número na lista seja importante, a propriedade CSS list-style-type deve ser usada em seu lugar.

Exemplos

Exemplo simples

html
<ol>
  <li>primeiro item</li>
  <li>segundo item</li>
  <li>terceiro item</li>
</ol>

A saída HTML acima será:

  1. primeiro item
  2. segundo item
  3. terceiro item

Usando o atributo start

html
<ol start="7">
  <li>primeiro item</li>
  <li>segundo item</li>
  <li>terceiro item</li>
</ol>

Listas aninhadas

html
<ol>
  <li>primeiro item</li>
  <li>
    segundo item
    <!-- Veja que a tag de fechamento </li> não é colocada aqui! -->
    <ol>
      <li>segundo item primeiro subitem</li>
      <li>segundo item segundo subitem</li>
      <li>segundo item terceiro subitem</li>
    </ol>
  </li>
  <!-- Aqui está a tag de fechamento </li> -->
  <li>terceiro item</li>
</ol>

A saída HTML acima será:

  1. primeiro item

  2. segundo item

    1. segundo item primeiro subitem
    2. segundo item segundo subitem
    3. segundo item terceiro subitem
  3. terceiro item

<ol> e <ul> aninhados

html
<ol>
  <li>primeiro item</li>
  <li>
    segundo item
    <!-- Observe que a tag de fechamento </li> não é colocada aqui! -->
    <ul>
      <li>segundo item primeiro subitem</li>
      <li>segundo item segundo subitem</li>
      <li>segundo item terceiro subitem</li>
    </ul>
  </li>
  <!-- Aqui está a tag de fechamento </li> -->
  <li>terceiro item</li>
</ol>

A saída HTML acima será:

  1. primeiro item

  2. segundo item

    • segundo item primeiro subitem
    • segundo item segundo subitem
    • segundo item terceiro subitem
  3. terceiro item

Especificações

Specification
HTML Standard
# the-ol-element

Compatibilidede em navegadores

BCD tables only load in the browser

Veja também

  • Outros elementos HTML relacionados à lista: <ul>, <li>, <menu> e o obsoleto <dir>;

  • Propriedades CSS que podem ser especialmente úteis para determinar o modelo do elemento<ol>:

    • a propriedade list-style, conveniente para escolher a forma como os ordinais são exibidos,
    • contadores CSS, útil para gerenciar listas complexas aninhadas,
    • a propriedade line-height, proficiente para simular o atributo obsoleto compact,
    • a propriedade margin, aplicável para controlar a indentação da lista.