Balise HTMLListes

<dl>

Une liste de description : des paires nom et description, par exemple un glossaire de termes ou des données techniques.

Affichage
block
Balise fermante
Obligatoire
Contenu autorisé
Groupes d’éléments <dt> et <dd>, éventuellement enveloppés dans un <div>
Sur cette page

Exemple

#
HTML
<dl>
  <dt>HTML</dt>
  <dd>Un langage de balisage qui décrit la structure d’une page.</dd>
  <dt>CSS</dt>
  <dd>Des feuilles de style responsables de l’apparence.</dd>
  <dt>JavaScript</dt>
  <dd>Un langage de programmation qui donne vie à la page.</dd>
</dl>
Aperçu

Définition et utilisation

#

L’élément <dl> (de l’anglais description list) regroupe des paires composées d’un nom et d’une description. Vous écrivez le nom dans <dt> et la description dans <dd>. Les usages typiques sont un glossaire de termes, la fiche technique d’un produit, les données d’un profil utilisateur (« E-mail », « Ville ») ou des questions et réponses.

Un même nom peut avoir plusieurs descriptions, et plusieurs noms (par exemple des synonymes) peuvent partager une seule description. Vous pouvez aussi envelopper chaque groupe dans un <div>, ce qui facilite le style, par exemple une mise en page sur deux colonnes avec CSS Grid.

N’utilisez pas <dl> pour écrire des dialogues ni uniquement pour obtenir un retrait. Le retrait d’une description n’est que le style par défaut de <dd>, que vous modifiez de toute façon généralement en CSS.

Syntaxe

#
Syntaxe
<dl>
  <dt>nom</dt>
  <dd>description</dd>
</dl>

Attributs

#

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

Plus d’exemples

#
Des groupes dans des éléments div et une mise en page en grille
HTML
<style>
  .course-info div { display: grid; grid-template-columns: 130px 1fr; }
  .course-info dt { font-weight: bold; }
  .course-info dd { grid-column: 2; margin: 0; }
</style>
<dl class="course-info">
  <div>
    <dt>Niveau</dt>
    <dd>Débutant</dd>
  </div>
  <div>
    <dt>Durée</dt>
    <dd>6 semaines</dd>
  </div>
  <div>
    <dt>Technologies</dt>
    <dd>HTML</dd>
    <dd>CSS</dd>
  </div>
</dl>
Aperçu

CSS par défaut

#

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

CSS
dl {
  display: block;
  margin-block: 1em;
}

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

#
  • Un nom dans <dt> n’est pas automatiquement une définition. Dans un glossaire, enveloppez le terme dans <dfn> pour indiquer qu’il est défini à cet endroit.
  • Chaque <div> à l’intérieur d’un <dl> doit contenir un ensemble complet : au moins un <dt> et au moins un <dd>.
  • <dt> n’est pas en gras par défaut. Si vous voulez mettre les noms en valeur, faites-le en CSS.

Entrées associées

#

Pratiquer dans les leçons

#

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