<li>

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.

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

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