<li>
Resumo
O 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>
(en-US)) 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>
(en-US). Embora seja um uso incomum, o obsoleto<dir>
pode ser pai, também. - Interface DOM
HTMLLIElement
(en-US)
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>
(en-US)).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
Deprecated-
A característica deste atributo é indicar o tipo de numeração:
a
: letras minúsculasA
: letras maiúsculasi
: algarismos romanos minúsculosI
: algarismos romanos maiúsculos1
: 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 CSS
list-style-type
(en-US).
Exemplos
<ol>
<li>primeiro item</li>
<li>segundo item</li>
<li>terceiro item</li>
</ol>
A saída HTML acima será:
- primeiro item
- segundo item
- terceiro item
<ul>
<li>primeiro item</li>
<li>segundo item</li>
<li>terceiro item</li>
</ul>
- primeiro item
- segundo item
- terceiro item
Especificações
Especificação | Estado | Observação |
---|---|---|
HTML Living Standard The definition of '<li>' in that specification. |
Padrão em tempo real | |
HTML5 The definition of '<li>' in that specification. |
Recomendação | |
HTML 4.01 Specification The definition of '<li>' in that specification. |
Recomendação |
Compatibilidade com navegadores
BCD tables only load in the browser
Veja também:
- Outros elementos HTML parentes:
<ul>
,<li>
,<menu>
(en-US) e o obsoleto<dir>
; - Propriedades CSS que podem ser úteis, especialmente para dar um charme ao elemento
<li>
:- a propriedade
list-style
(en-US), para escolher a maneira como os posicionamentos serão exibidos, - contadores CSS (en-US) para controlar listas aninhadas complexas,
- a propriedade
margin
, para controlar a indentação dos itens da lista.
- a propriedade