<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

<p>Apollo astronauts:</p>

<ul>
  <li>Neil Armstrong</li>
  <li>Alan Bean</li>
  <li>Peter Conrad</li>
  <li>Edgar Mitchell</li>
  <li>Alan Shepard</li>
</ul>

p,
li {
  font:
    1rem "Fira Sans",
    sans-serif;
}

p {
  font-weight: bold;
}

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

Compatibilité des navigateurs

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.