<summary>

Le titre toujours visible d’un élément `<details>`, qui déplie et replie le contenu.

Affichage
list-item
Balise fermante
Obligatoire
Contenu autorisé
Contenu phrasé, éventuellement avec des titres <h1>-<h6>
Sur cette page

Exemple

#
HTML
<style>
  summary { cursor: pointer; font-weight: 600; }
  summary::marker { color: #f97316; }
</style>
<details>
  <summary>Module 3 : les formulaires (6 leçons)</summary>
  <ol>
    <li>L’élément form</li>
    <li>Les champs de texte</li>
    <li>Les cases à cocher et les boutons radio</li>
  </ol>
</details>
Aperçu

Définition et utilisation

#

L’élément <summary> est l’étiquette du widget <details> : le texte toujours visible sur lequel on clique pour déplier ou replier le reste. Il doit être le premier enfant de <details>. Si vous l’omettez, le navigateur affiche son propre libellé, généralement « Détails » ou « Details ».

Le navigateur traite <summary> comme un bouton : on peut le sélectionner avec la touche Tab et l’activer avec Entrée ou la barre d’espace. Il a par défaut display: list-item, c’est pourquoi il affiche un marqueur triangulaire qui change de direction lorsque la section est dépliée.

Il peut contenir du texte, des mises en valeur, et même un titre (<h1>-<h6>) si la section fait partie de la structure du document. Évitez d’y mettre des liens et des boutons, car un clic sur eux déplierait aussi la section.

Syntaxe

#
Syntaxe
<summary>Texte du titre</summary>

Attributs

#

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

CSS par défaut

#

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

CSS
details > summary:first-of-type {
  display: list-item;
  list-style: disclosure-closed inside;
}
details[open] > summary:first-of-type {
  list-style-type: disclosure-open;
}

Compatibilité des navigateurs

#

Largement disponible · depuis 2020

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Le triangle est un marqueur de liste. Vous le masquez avec summary { list-style: none; }, et dans les anciennes versions de Safari aussi avec summary::-webkit-details-marker { display: none; }.
  • Rédigez un texte qui dit ce qui va se déplier, par exemple « Afficher la solution », plutôt que simplement « Plus ».

Entrées associées

#

Pratiquer dans les leçons

#

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