CSS list-style-type : choisir les puces et la numérotation

La propriété CSS list-style-type définit la puce ou le format du numéro placé devant chaque élément de liste. Utilisez <ol> lorsque l’ordre compte et <ul> pour une énumération sans ordre imposé. Pour commencer au numéro trois, ajoutez start="3" à <ol>.

Choisir une valeur de list-style-type

disc, circle et square produisent un disque plein, un cercle vide ou un carré. decimal emploie les chiffres décimaux et lower-roman les chiffres romains en minuscules. none masque le marqueur textuel par défaut.

La valeur initiale de la propriété est disc. La feuille de style du navigateur attribue généralement decimal à <ol>. La valeur calculée d’un élément de liste permet de vérifier la règle appliquée.

ol.steps { list-style-type: lower-roman; }
ul.topics { list-style-type: square; }

Tester le résultat dans le navigateur

Enregistrez le document complet dans list-style-type.html en UTF-8, puis ouvrez-le dans un navigateur. Chaque liste possède une classe distincte pour permettre une comparaison indépendante.

<!doctype html>
<html lang="fr">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Étapes / Sujets</title>
  <style>
    .steps, .topics { padding-inline-start: 2em; }
    ol.steps { list-style-type: lower-roman; }
    ul.topics { list-style-type: square; }
  </style>
</head>
<body>
  <h1>Étapes</h1>
  <ol class="steps">
    <li>Enregistrer le fichier</li>
    <li>Ouvrir le fichier</li>
  </ol>
  <h2>Sujets</h2>
  <ul class="topics">
    <li>HTML</li>
    <li>CSS</li>
  </ul>
</body>
</html>

Les étapes portent les numéros i. et ii.. Les sujets sont précédés de puces carrées.

  1. Dans la règle .steps, remplacez lower-roman par decimal, puis par none. Vérifiez que l’ordre des éléments reste identique et rétablissez lower-roman.
  2. Ajoutez start="3" à la balise <ol>. Vous obtenez iii. et iv.. Retirez l’attribut pour revenir au début.

Standard HTML pour les listes ordonnées

Héritage, images et propriété raccourcie

Les éléments héritent généralement de la valeur de leur liste. Le navigateur peut toutefois définir une valeur propre à une liste imbriquée. Pour reprendre le style extérieur, ciblez la liste intérieure avec une règle comme .features ul { list-style-type: inherit; }.

Une image list-style-image valide ou un contenu explicite de ::marker peut fournir le marqueur visible. Le raccourci list-style: inside réinitialise le type et l’image omis. Pour déplacer le marqueur tout en conservant ces valeurs, utilisez list-style-position: inside.

Spécification du W3C sur les marqueurs

Diagnostiquer un marqueur manquant

  1. Inspectez le <li> concerné et contrôlez les valeurs calculées de display et de list-style-type. Si display: flex supprime la boîte qui génère le marqueur, placez le conteneur Flexbox à l’intérieur de l’élément.
  2. Désactivez séparément les règles d’image et de ::marker. Si les valeurs sont correctes, vérifiez le retrait au début de la ligne et le overflow des ancêtres. Un marqueur extérieur risque d’être rogné.

Conservez les numéros lorsque les lecteurs s’en servent pour suivre les étapes. Dans certains contextes, Safari peut écarter une liste sans marqueurs de l’arbre d’accessibilité en tant que liste. Vérifiez le rendu avec les outils ciblés et ajoutez role="list" si nécessaire. Notes d’accessibilité de MDN