[go: up one dir, main page]

Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

<li> : l'élément dans une liste

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨juillet 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 avec des puces. Dans les listes ordonnées, ils sont habituellement affichés avec un compteur croissant à gauche, tel qu'un nombre ou une lettre.

Exemple interactif

<p>Astronautes d'Apollo&nbsp;:</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>).

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

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ôle ARIA implicite listitem lorsque enfant d'un élément ol, ul ou menu
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.