<li>

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.

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

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 d'utilisation : Cet attribut a été déprécié : utilisez la propriété CSS list-style-type à la place.

Exemples

Liste ordonnée

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

<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

<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` (en-US)

Spécifications

Spécification	Statut	Commentaire
HTML Living Standard La définition de '<li>' dans cette spécification.	Standard évolutif
HTML5 La définition de '<li>' dans cette spécification.	Recommendation
HTML 4.01 Specification La définition de '<li>' dans cette spécification.	Recommendation	L'attribut `type` a été déprécié.

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.