L'élément HTML <li> représente un élément d'une liste. Cet élément doit être contenu dans une liste ordonnée (c'est-à-dire au sein d'un élément <ol>), dans une liste non ordonnée (c'est-à-dire au sein d'un élément <ul>) ou dans un menu (<menu>). Pour les menus et les listes non-ordonnées, les éléments sont généralement affichés après une puce. Pour les listes ordonnées, un indicateur ordinal (un nombre ou une lettre) est utilisé.

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 l'élément parent.
Parents autorisés Un élément <ul>, <ol> ou <menu>. L'élément obsolète <dir> pouvait également être un parent (usage non-conforme désormais).
Rôles ARIA autorisés menuitem, menuitemcheckbox, menuitemradio, option, presentation, radio, separator, tab, treeitem.
Interface DOM HTMLLIElement

Attributs

Comme tous les éléments HTML, cet élément peut inclure les attributs universels.

value
Cette valeur entière indique la position ordinale de l'élément dans la liste décrite par l'élément <ol>. La valeur de cet attribut doit être un nombre, même lorsque la liste est affichée avec des chiffres romains ou des lettres. Les éléments de la liste qui suivent cet élément poursuivront la numérotation à partir de cette valeu. L'attribut value n'a aucune signification pour les listes non-ordonnées (<ul>) ou les menus (<menu>).
Note : Cet attribut était déprécié en HTML4 mais fut réintroduit en HTML5.

Attributs dépréciés

type
Ce caractère indique le type de numérotation utilisé pour la liste :
  • a : lettres latines en minuscules
  • A : lettres latines en majuscules
  • i : chiffres romains en minuscules
  • I : chiffres romains en majuscules
  • 1 : nombres
Ce type surcharge celui de l'élément parent <ol> s'il y était utilisé.
Note : Cet attribut est désormais déprécié, il faut utiliser la propriété CSS list-style-type à la place.

Exemples

Exemple simple

HTML

<ul>
  <li>50g de sucre</li>
  <li>2 tablettes de chocolat</li>
  <li>1 andouillette de Guéméné</li>
</ul>

Résultat

Utilisation de l'attribut value

HTML

<ol>
  <li>Un premier élément</li>
  <li>Un deuxième</li>
  <li value="4">On passe directement au quatrième</li>
  <li>Du coup voici le cinquième</li>
</ol>

Résultat

Spécifications

Spécification État Commentaires
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 Dépréciation de l'attribut type.

Compatibilité des navigateurs

FonctionnalitéChromeEdgeFirefoxInternet ExplorerOperaSafari
Support simple (Oui) (Oui)1 (Oui) (Oui) (Oui)
value (Oui) (Oui)1 (Oui) (Oui) (Oui)
type (Oui) (Oui)1 (Oui) (Oui) (Oui)
FonctionnalitéAndroidChrome for AndroidEdge mobileFirefox for AndroidIE mobileOpera AndroidiOS Safari
Support simple (Oui) (Oui) (Oui)1 (Oui) (Oui) (Oui)
value (Oui) (Oui) (Oui)1 (Oui) (Oui) (Oui)
type (Oui) (Oui) (Oui)1 (Oui) (Oui) (Oui)

Voir aussi

  • Les autres éléments liés aux listes :
  • Les propriétés CSS qui peuvent s'avérer utiles pour mettre en forme l'élément <li> :
    • list-style qui permet de choisir comment afficher l'indicateur ordinal
    • Les compteurs CSS qui permettent de gérer des listes imbriquées complexes
    • margin qui permet de contrôler l'indentation des éléments

Étiquettes et contributeurs liés au document

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