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

L'élément HTML <li> est utilisé pour représenter un élément dans une liste. Il doit être contenu dans un élément parent : une liste ordonnée (<ol>), une liste non ordonnée (<ul>) ou un menu (<menu>). Dans les menus et les listes non ordonnées, les éléments de liste sont habituellement affichés en utilisant des puces. Dans les listes ordonnées, ils sont habituellement affichés avec compteur croissant à gauche, tel qu'un nombre ou une lettre.

Exemple interactif

Attributs

Cet élément inclut les attributs universels.

value

Cette valeur entière indique la valeur ordinale en cours de l'élément de liste tel que défini par l'élément <ol>. La seule valeur autorisée pour cet attribut est un nombre, même si la liste est affichée avec des chiffres romains ou des lettres. Les éléments de la liste qui suivent celui-ci continueront la numérotation à partir de la valeur indiquée. L'attribut value n'a pas de signification pour les listes non ordonnées (<ul>) ou pour les menus (<menu>).

Note : Cet attribut a été déprécié en HTML4 mais a été réintroduit en HTML5.

Note : Avant Gecko 9.0, des valeurs négatives étaient incorrectement converties en 0. A partir de Gecko 9.0, toutes les valeurs entières ont été correctement analysées.

type Obsolète

Cet attribut de caractère indique le type de numérotation utilisé pour la liste :

  • a : lettres minuscules
  • A : lettres majuscules
  • i : chiffres romains en minuscules
  • I : chiffres romains en majuscules
  • 1 : nombres

Ce type surcharge celui utilisé par son élément parent <ol> si présent.

Note : Cet attribut a été déprécié : utilisez la propriété CSS list-style-type à la place.

Exemples

Liste ordonnée

HTML

html
<ol>
  <li>premier article</li>
  <li>second article</li>
  <li>troisième article</li>
</ol>

Résultat

Liste ordonnée démarrant avec un indice donné

HTML

html
<ol type="I">
  <li value="3">troisième article</li>
  <li>quatrième article</li>
  <li>cinquième article</li>
</ol>

Résultat

Liste non ordonnée

HTML

html
<ul>
  <li>premier article</li>
  <li>second article</li>
  <li>troisième article</li>
</ul>

Résultat

Note : Pour d'autres exemples plus détaillés, voir les pages <ol> et <ul>.

Résumé technique

Catégories de contenu Aucune.
Contenu autorisé Contenu de flux.
Omission de balises La balise de fin peut être absente si l'élément est immédiatement suivi par un autre élément <li> ou s'il n'y a plus d'autre contenu dans son élément parent.
Parents autorisés Un élément <ul>, <ol> ou <menu>. Bien que ce ne soit pas un usage conforme, l'élément obsolète <dir> peut également être un parent.
Rôles ARIA autorisés menuitem, menuitemcheckbox, menuitemradio, option, presentation, radio, separator, tab, treeitem.
Interface DOM HTMLLIElement

Spécifications

Specification
HTML Standard
# the-li-element

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi

  • Les autres éléments liés aux listes : <ul>, <ol>, <menu> et <dir> (obsolète) ;

  • Les propriétés CSS qui peuvent être particulièrement utiles pour mettre en forme l'élément <li> :

    • la propriété list-style, pour choisir la manière d'afficher l'ordinal,
    • les compteurs CSS, pour gérer des listes imbriquées complexes,
    • la propriété margin, pour contrôler l'indentation de l'élément de liste.