<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>
Exemple
#<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>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
#<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
#<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>CSS par défaut
#La plupart des navigateurs affichent cet élément avec ces styles par défaut :
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
#- <dt>Un nom, un terme ou une question dans une liste de description `<dl>`.
- <dd>La description ou la valeur associée à un nom `<dt>` dans une liste de description.
- <ul>Une liste à puces dans laquelle l’ordre des éléments n’a pas d’importance.
- <ol>Une liste numérotée dans laquelle l’ordre des éléments a de l’importance.
- <dfn>Un terme défini à cet endroit du texte, c’est-à-dire la première utilisation, explicative, du concept.
Pratiquer dans les leçons
#Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.