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

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidEdge MobileFirefox pour AndroidOpera pour AndroidSafari pour iOSSamsung Internet
Support simpleChrome Support complet OuiEdge Support complet OuiFirefox Support complet 1IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiEdge Mobile Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui
valueChrome Support complet OuiEdge Support complet OuiFirefox Support complet 1IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiEdge Mobile Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui
type
ObsolèteNon-standard
Chrome Support complet OuiEdge Support complet OuiFirefox Support complet 1IE Support complet OuiOpera Support complet OuiSafari Support complet OuiWebView Android Support complet OuiChrome Android Support complet OuiEdge Mobile Support complet OuiFirefox Android Support complet 4Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui

Légende

Support complet  
Support complet
Fonctionnalité non-standard. Celle-ci peut être incorrectement supportée par les autres navigateurs.
Fonctionnalité non-standard. Celle-ci peut être incorrectement supportée par les autres navigateurs.
Obsolète. Les nouveaux sites web ne doivent pas utiliser cette fonctionnalité.
Obsolète. Les nouveaux sites web ne doivent pas utiliser cette fonctionnalité.

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,