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'attributvaluen'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 minusculesA: lettres latines en majusculesi: chiffres romains en minusculesI: chiffres romains en majuscules1: nombres
<ol>s'il y était utilisé.Note : Cet attribut est désormais déprécié, il faut utiliser la propriété CSSlist-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 |
|---|---|---|
| WHATWG 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é | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| Support simple | (Oui) | (Oui) | 1.0 (1.7 ou moins)[1] | (Oui) | (Oui) | (Oui) |
| Fonctionnalité | Android | Edge | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| Support simple | (Oui) | (Oui) | 1.0 (1.0)[1] | (Oui) | (Oui) | (Oui) |
[1] Avant Gecko 9.0, le comportement était incorrect car les valeurs négatives étaient converties en 0. Toutes les valeurs entières sont correctement converties à partir de Gecko 9.0.
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-stylequi permet de choisir comment afficher l'indicateur ordinal- Les compteurs CSS qui permettent de gérer des listes imbriquées complexes
marginqui permet de contrôler l'indentation des éléments

