Resumo

OelementoHTML<li> (ou a Lista dos Itens de um elemento HTML) é usado para representar um item que faz parte de uma lista. Este item deve estar contido em um elemento pai: uma lista ordenada (<ol>), uma lista desordenada (<ul>) , ou um menu (<menu>) e representa uma única entidade dessa lista. Em menus e listas desordenadas a relação de itens é exibida, normalmente, usando pontos de marcação (as bolinhas). Em listas ordenadas eles são, comumente, mostrados com algum contador ascendente - como um número, ou letra - à sua esquerda.

• Categorias de conteúdo Nenhuma.
• Conteúdo permitidoFlutuantes.
• Omissão de etiquetas (tags) A etiqueta de fim pode ser omitida se esta for imediatamente seguida por um outro elemento<li>, ou se não houver mais conteúdo no seu elemento pai.
• Elementos pai permitidos Um elemento<ul>,<ol>, ou<menu>. Embora seja um uso incomum, o obsoleto<dir> pode ser pai, também.
• Interface DOMHTMLLIElement

Atributos

Este elemento inclui osatributos globais.

value

Este atributo de número inteiro indica o valor ordinal atual do item na lista, definido pelo elemento<ol>. O único valor possível para este atributo é um número, ainda que a lista seja exibida com algarismos romanos, ou letras. A lista de itens que virá em seguida continuará a ser numerada a partir desta posição. O atributovalue não tem significado para listas desordenadas (<ul>), nem para menus (<menu>).

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

Nota:Antes de Gecko 9.0, os valores negativos eram, incorretamente, convertidos a 0. A partir de Gecko 9.0 todos os valores inteiros são analisados corretamente.

typeDeprecated

A característica deste atributo é indicar o tipo de numeração:

• a: letras minúsculas
• A: letras maiúsculas
• i: algarismos romanos minúsculos
• I: algarismos romanos maiúsculos
• 1: números

Este tipo substitui o utilizado pelo seu elemento pai<ol>, qualquer que seja.

Note:Nota de utilização: Este atributo foi preterido. Em seu lugar use a propriedade CSSlist-style-type.

Exemplos

<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

<ul>  <li>primeiro item</li>  <li>segundo item</li>  <li>terceiro item</li></ul>

• primeiro item
• segundo item
• terceiro item

Para exemplos mais detalhados veja as páginas<ol> e<ul>.

Especificações

Compatibilidade com navegadores

Veja também

• Outros elementos HTML parentes:<ul>,<li>,<menu> e o obsoleto<dir>;
• Propriedades CSS que podem ser úteis, especialmente para dar um charme ao elemento<li>:
  • a propriedadelist-style, para escolher a maneira como os posicionamentos serão exibidos,
  • contadores CSS para controlar listas aninhadas complexas,
  • a propriedademargin, para controlar a indentação dos itens da lista.