<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.

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ú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 CSS list-style-type (en-US).

Exemplos

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
html
<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

Specification
HTML Standard
# the-li-element

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.