<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>
Exemple
#<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>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
#<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 :
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 avecsummary::-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
#- <details>Une section dépliable : le titre `<summary>` est toujours visible, et le reste du contenu apparaît au clic.
- <button>Un bouton cliquable : il envoie un formulaire, le réinitialise, ou lance une action sur la page.
- <h1>-<h6>Des titres à six niveaux, du plus important h1 au moins important h6. Ensemble, ils forment le plan de la page.
Pratiquer dans les leçons
#Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.