Balise HTMLListes

<ul>

Une liste à puces dans laquelle l’ordre des éléments n’a pas d’importance.

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

Exemple

#
HTML
<h3>Ce que vous apprendrez dans la formation HTML</h3>
<ul>
  <li>construire la structure d’une page avec des titres et des paragraphes</li>
  <li>insérer des images, des liens et des listes</li>
  <li>créer des formulaires de contact</li>
  <li>publier une page sur internet</li>
</ul>
Aperçu

Définition et utilisation

#

L’élément <ul> (de l’anglais unordered list) crée une liste non ordonnée. Vous écrivez chaque élément dans un <li> distinct, et le navigateur place une puce devant. Utilisez <ul> lorsque l’échange de l’ordre des éléments ne change pas le sens : une liste des avantages d’une formation, les ingrédients d’une recette, les tags sous un article.

Si l’ordre compte (étapes d’un mode d’emploi, classement), utilisez <ol>. Lorsque les éléments sont des paires « nom et description », <dl> convient mieux. Les listes peuvent être imbriquées, mais une sous-liste se place toujours à l’intérieur d’un élément <li>, jamais directement dans le <ul>.

La plupart des menus de navigation reposent aussi sur des listes. Les lecteurs d’écran annoncent le début d’une liste et donnent le nombre de ses éléments, ce qui aide à évaluer la longueur d’un menu. Vous modifiez la forme des puces en CSS avec la propriété list-style, et vous stylez les puces elles-mêmes avec le pseudo-élément ::marker.

Syntaxe

#
Syntaxe
<ul>
  <li>…</li>
  <li>…</li>
</ul>

Attributs

#

Cet élément n’a pas d’attributs propres. Il accepte les attributs globaux, comme class, id ou hidden.

Plus d’exemples

#
Une liste imbriquée
HTML
<ul>
  <li>Frontend
    <ul>
      <li>HTML</li>
      <li>CSS</li>
      <li>JavaScript</li>
    </ul>
  </li>
  <li>Backend
    <ul>
      <li>Python</li>
      <li>Node.js</li>
    </ul>
  </li>
</ul>
Aperçu

CSS par défaut

#

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

CSS
ul {
  display: block;
  list-style-type: disc;
  margin-block: 1em;
  padding-inline-start: 40px;
}
ul ul {
  list-style-type: circle;
  margin-block: 0;
}

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

#
  • Le seul enfant direct de <ul> peut être <li>. Placez un titre, un paragraphe ou une sous-liste à l’intérieur du <li>.
  • Lorsque vous supprimez les puces avec list-style: none, VoiceOver dans Safari peut cesser d’annoncer la liste. Vous pouvez le rétablir avec l’attribut role="list".
  • L’attribut type sur <ul> (par exemple type="square") est obsolète. Définissez la forme de la puce en CSS : list-style-type: square.

Entrées associées

#

Pratiquer dans les leçons

#

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