Balise HTMLListes

<ol>

Une liste numérotée dans laquelle l’ordre des éléments a de l’importance.

Affichage
block
Balise fermante
Obligatoire
Contenu autorisé
Éléments <li> (<script> et <template> sont aussi autorisés)
Sur cette page

Exemple

#
HTML
<h3>Comment publier votre première page</h3>
<ol>
  <li>Créez un fichier <code>index.html</code>.</li>
  <li>Ajoutez un titre et quelques paragraphes.</li>
  <li>Vérifiez la page dans le navigateur.</li>
  <li>Envoyez le fichier sur un hébergeur.</li>
</ol>
Aperçu

Définition et utilisation

#

L’élément <ol> (de l’anglais ordered list) crée une liste ordonnée. Le navigateur numérote lui-même les éléments <li>, la numérotation reste donc juste après l’ajout ou la suppression d’une étape. C’est un bon choix pour les instructions pas à pas, les recettes, les classements et les tables des matières.

Vous adaptez la numérotation avec des attributs : start définit le premier numéro, reversed inverse l’ordre, et type remplace les chiffres par des lettres ou des chiffres romains. Vous pouvez donner à un seul élément son propre numéro avec l’attribut value de l’élément <li>.

Demandez-vous si un changement d’ordre ferait perdre son sens à la liste. Si oui, choisissez <ol>, sinon <ul> suffit. Les lecteurs d’écran annoncent la liste et le nombre de ses éléments, il est donc facile de suivre à quelle étape des instructions on se trouve.

Syntaxe

#
Syntaxe
<ol>
  <li>…</li>
  <li>…</li>
</ol>

Attributs

#
  • start

    nombre entier

    Le numéro à partir duquel la liste commence. Utile lorsqu’un paragraphe interrompt la liste et que la numérotation doit continuer. Fonctionne aussi avec les lettres et les chiffres romains : start="3" avec type="a" commencera à « c ».
  • reversed

    attribut booléen

    Inverse la numérotation, la liste décompte donc. Convient aux classements qui se terminent par le gagnant. L’ordre des éléments dans le code ne change pas, seuls les numéros changent.
  • type

    1 | a | A | i | I

    Le type de numérotation : chiffres (1, par défaut), lettres minuscules ou majuscules (a, A), ou chiffres romains minuscules ou majuscules (i, I). Utilisez-le lorsque le type de numéro a de l’importance, par exemple dans un règlement avec des points « a », « b », « c ». Pour des besoins purement visuels, la propriété CSS list-style-type est préférable.

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

Attributs en pratique

#

start

nombre entier

Le numéro à partir duquel la liste commence. Utile lorsqu’un paragraphe interrompt la liste et que la numérotation doit continuer. Fonctionne aussi avec les lettres et les chiffres romains : start="3" avec type="a" commencera à « c ».

HTML
<p>Nous avons vu les étapes 1 à 3 dans la leçon précédente.</p>
<ol start="4">
  <li>Ajoutez une feuille de style.</li>
  <li>Définissez les couleurs et les polices.</li>
</ol>
Aperçu

reversed

attribut booléen

Inverse la numérotation, la liste décompte donc. Convient aux classements qui se terminent par le gagnant. L’ordre des éléments dans le code ne change pas, seuls les numéros changent.

HTML
<h4>Top 3 des langages parmi nos élèves</h4>
<ol reversed>
  <li>Python</li>
  <li>JavaScript</li>
  <li>HTML et CSS</li>
</ol>
Aperçu

type

1 | a | A | i | I

Le type de numérotation : chiffres (1, par défaut), lettres minuscules ou majuscules (a, A), ou chiffres romains minuscules ou majuscules (i, I). Utilisez-le lorsque le type de numéro a de l’importance, par exemple dans un règlement avec des points « a », « b », « c ». Pour des besoins purement visuels, la propriété CSS list-style-type est préférable.

HTML
<p>Un participant à la formation a droit à :</p>
<ol type="a">
  <li>l’accès à toutes les leçons,</li>
  <li>l’aide d’un mentor,</li>
  <li>une pause dans l’apprentissage sans perdre sa progression.</li>
</ol>
Aperçu

CSS par défaut

#

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

CSS
ol {
  display: block;
  list-style-type: decimal;
  margin-block: 1em;
  padding-inline-start: 40px;
}

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

#
  • N’écrivez pas les numéros à la main dans le texte des éléments. Le navigateur numérote lui-même, et les numéros manuels se désynchronisent dès la première modification.
  • Vous modifiez l’apparence des numéros en CSS avec li::marker, par exemple la couleur ou l’épaisseur de la police.
  • Vous pouvez construire une numérotation à plusieurs niveaux dans le style « 1.2.3 » avec les compteurs CSS : counter-reset, counter-increment et counters().

Entrées associées

#

Pratiquer dans les leçons

#

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