<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
# the-li-element

Compatibilidade com navegadores

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
li
type
Deprecated
value

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Deprecated. Not for use in new websites.

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.