Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

dl — liste de descriptions

L’élément `dl` représente des associations entre noms et valeurs, comme des métadonnées, des questions et réponses, ou des termes et définitions. Les noms se placent dans des éléments `dt` et les valeurs correspondantes dans des éléments `dd`.

Version : WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

<dl>
  <dt>Name</dt>
  <dd>Value</dd>
</dl>

dl est une liste de groupes nom-valeur, et pas seulement un dictionnaire de définitions. Chaque groupe contient au moins un élément dt, suivi d’au moins un élément dd. Plusieurs noms peuvent partager des valeurs ; des éléments dd consécutifs représentent des valeurs distinctes. Placez dans un même dd les paragraphes qui correspondent à une seule valeur.

Placez les groupes directement dans dl, ou enveloppez chaque groupe dans un div, par exemple pour le styliser. Ne mélangez pas ces structures dans une même liste. Les deux structures autorisent également les éléments qui prennent en charge les scripts. La liste peut être vide.

dl nécessite une balise ouvrante et une balise fermante, et accepte les attributs globaux. L’ordre des groupes, des noms et des valeurs peut être important. Évitez de répéter le même nom dans plusieurs éléments dt. Un dt à lui seul ne signale pas qu’un terme est formellement défini ; utilisez dfn pour cela.

Exemples

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Product details</title>
<dl>
  <div>
    <dt>Model</dt>
    <dd>Atlas</dd>
  </div>
  <div>
    <dt>Available colors</dt>
    <dd>Blue</dd>
    <dd>Green</dd>
  </div>
</dl>
</html>

Résultat

Model
Atlas
Available colors
Blue
Green

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources