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.

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

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

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

L'HTML ci-dessus affichera :

  1. premier article
  2. second article
  3. troisième article
<ol type="I">
    <li value="3">troisième article</li>
    <li>quatrième article</li>
    <li>cinquième article</li>
</ol>

L'HTML ci-dessus affichera :

  1. troisième article
  2. quatrième article
  3. cinquième article
<ul>
    <li>premier article</li>
    <li>second article</li>
    <li>troisième article</li>
</ul>
  • premier article
  • second article
  • troisième article

Pour des exemples plus détaillés, voir les pages <ol> et <ul>.

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

FonctionnalitéChromeEdgeFirefoxInternet ExplorerOperaSafari
Support simple Oui Oui1 Oui Oui Oui
value Oui Oui1 Oui Oui Oui
type Oui Oui1 Oui Oui Oui
FonctionnalitéAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Support simple Oui Oui Oui4 Oui Oui Oui
value Oui Oui Oui4 Oui Oui Oui
type Oui Oui Oui4 Oui Oui Oui

Voir aussi

  • Les autres éléments liés aux listes : <ul>, <li><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.

Étiquettes et contributeurs liés au document

Contributeurs à cette page : SphinxKnight, NemoNobobyPersonne, tregagnon
Dernière mise à jour par : SphinxKnight,