Balise HTMLListes

<li>

Un élément unique d’une liste `<ul>`, `<ol>` ou `<menu>`.

Affichage
list-item
Balise fermante
Obligatoire
Contenu autorisé
Contenu de flux (flow content)
Sur cette page

Exemple

#
HTML
<ol>
  <li>Module 1 : la structure du document</li>
  <li>
    Module 2 : texte et liens
    <ul>
      <li>paragraphes et titres</li>
      <li>hyperliens</li>
    </ul>
  </li>
  <li>Module 3 : les images</li>
</ol>
Aperçu

Définition et utilisation

#

L’élément <li> (de l’anglais list item) désigne un élément d’une liste. Il doit se trouver directement dans un <ul>, un <ol> ou un <menu>. Le fait qu’une puce ou un numéro apparaisse devant le contenu dépend du parent, et non du <li> lui-même.

À l’intérieur, vous pouvez placer n’importe quel contenu de flux : du texte, un lien, une image, plusieurs paragraphes, voire une autre liste. C’est ainsi que l’on construit des listes imbriquées, par exemple un menu avec un sous-menu ou un programme de formation divisé en modules et en leçons.

Par défaut, l’élément a display: list-item, c’est pourquoi il génère un marqueur (une puce ou un numéro). Vous stylez le marqueur avec le pseudo-élément ::marker, et vous le masquez en définissant list-style: none sur la liste.

Syntaxe

#
Syntaxe
<li>contenu de l’élément</li>

Attributs

#
  • value

    nombre entier

    Définit le numéro de cet élément dans une liste <ol>. Les éléments suivants continuent à compter à partir de la valeur indiquée. Dans les listes <ul> et <menu>, l’attribut ne s’applique pas.

L’élément accepte aussi tous les attributs globaux, comme class, id, style ou hidden.

Attributs en pratique

#

value

nombre entier

Définit le numéro de cet élément dans une liste <ol>. Les éléments suivants continuent à compter à partir de la valeur indiquée. Dans les listes <ul> et <menu>, l’attribut ne s’applique pas.

HTML
<h4>Classement de la semaine</h4>
<ol>
  <li>Ola, 980 pts</li>
  <li>Kuba, 870 pts</li>
  <li value="2">Maja, 870 pts</li>
  <li>Tomek, 750 pts</li>
</ol>
Aperçu

CSS par défaut

#

La plupart des navigateurs affichent cet élément avec ces styles par défaut :

CSS
li {
  display: list-item;
}

Compatibilité des navigateurs

#

Largement disponible

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Placez une sous-liste à l’intérieur du <li>, et non à côté. Un <ul> inséré directement dans une autre liste est une erreur de syntaxe.
  • Vous modifiez la couleur et la taille de la puce sans éléments supplémentaires : li::marker { color: orange; }.
  • Si tout l’élément doit être cliquable, placez-y un lien <a> et agrandissez-le en CSS. Ne rattachez pas la gestion du clic au <li> lui-même.

Entrées associées

#

Pratiquer dans les leçons

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.