<li>

Résumé

L'élément HTML <li> (List Item) est utilisé pour représenter un élément d'une liste. Il doit appartenir à une liste ordonnée (<ol>), à une liste non-ordonnée (<ul>) ou à un menu (<menu>), dans lesquels il désigne un élément unique de cette liste. Au sein des menus ou des listes non-ordonnées, les éléments d'une liste sont généralement affichés avec des puces rondes. Dans les listes ordonées, la puce d'un élément est le plus souvent un nombre ou une lettre affiché(e) à gauche (respectant l'ordre décroissant de la liste).

• 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 appartenant à l'élément parent.
• Élément parents autorisés Un élément <ul>, <ol> ou <menu>. Bien que non-conforme, l'élément obsolète <dir> peut également être un parent.
• Interface DOM HTMLLIElement

Attributs

Cet élément inclut les attributs globaux.

value

Cet attribut indique la valeur (avec un nombre entier) du nombre ordinal de l'élément appartenant à un élément <ol>. Les seules valeurs possibles pour cet attribut sont des nombres entiers, et ce même si la liste est affichée avec des nombres romains ou des lettres. Les éléments suivant dans la liste poursuivront la numérotation à partir de cette valeur. Cet attribut n'a pas de sens pour les éléments (<ul>) ou (<menu>).

Note : Cet attribut était déprécié en HTML4 mais a été réintroduit en HTML5.

Gecko 9.0 note

(Firefox 9.0 / Thunderbird 9.0 / SeaMonkey 2.6)

Avant Gecko 9.0, les valeurs négatives étaient changées en 0, ce qui était incorrect. Avec Gecko 9.0 et les versions ultérieurs, les valeurs de l'attribut sont analysées correctement.

type

Cet attribut définit comment les nombres ordinaux doivent être affichés. Il peut valoir les caractères suivants :

• a : lettres minuscules
• A : lettres majuscules
• i : nombres romains en minuscules
• I : nombres romains en majuscules
• 1 : nombres

Cette dernière valeur surcharge l'éventuelle valeur utilisée par l'élément parent <ol>.

Note d'utilisation : Cet attribut a été déprécié. La propriété CSS list-style-type doit être utilisé à la place de cet attribut.

Exemples

<ol>
    <li>Premier élément</li>
    <li>Deuxième élément</li>
    <li>Troisième élément</li>
</ol>	

Le fragment de code HTML ci-dessus produira le résultat suivant

1. Premier élément
2. Deuxième élément
3. Troisième élément

<ul>
    <li>Premier élément</li>
    <li>Deuxième élément</li>
    <li>Troisième élément</li>
</ul>

• Premier élément
• Deuxième élément
• Troisième élément

Pour plus d'exemples, vous pouvez consulter les pages <ul>) et (<ol>.

Spécifications

Compatibilité des navigateurs

Voir également

• D'autres éléments HTML en lien avec les listes : <ul>, <li>, <menu> (et <dir> qui est obsolète)
• Les propriétés CSS pouvant être utile à la mise en forme de l'élément <li> :
  • la propriété list-style pour choisir l'affichage des nombres ordinaux
  • les compteurs CSS pour gérer les listes imbriquées complexes
  • la propriété margin permettant de contrôler l'indentation des éléments d'une liste