<li>

Resumo

elemento HTML <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 permitido Flutuantes.
  • 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 DOM HTMLLIElement

Atributos

Este elemento inclui os atributos 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 atributo value 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.

type
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.
Nota de utilização: Este atributo foi preterido. Em seu lugar use a propriedade CSS list-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

Especificação Estado Observação
WHATWG HTML Living Standard
The definition of '<li>' in that specification.
Living Standard  
HTML5
The definition of '<li>' in that specification.
Recommendation  
HTML 4.01 Specification
The definition of '<li>' in that specification.
Recommendation  

Compatibilidade em navegadores

Recurso   Chrome   Firefox (Gecko)    Internet Explorer    Opera    Safari
Suporte básico (Yes) 1.0 (1.7 or earlier) (Yes) (Yes) (Yes)
Recurso   Android Firefox Móvel (Gecko) IE Móvel Opera Móvel Safari Móvel
Suporte básico (Yes) 1.0 (1.0) (Yes) (Yes) (Yes)

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 propriedade list-style, para escolher a maneira como os posicionamentos serão exibidos,
    • contadores CSS para controlar listas aninhadas complexas,
    • a propriedade margin, para controlar a indentação dos itens da lista.

Etiquetas do documento e colaboradores

 Colaboradores desta página: Aschlla, flpms
 Última atualização por: Aschlla,