<details>

Une section dépliable : le titre `<summary>` est toujours visible, et le reste du contenu apparaît au clic.

Affichage
block
Balise fermante
Obligatoire
Contenu autorisé
Un élément <summary>, suivi de contenu de flux
Sur cette page

Exemple

#
HTML
<details>
  <summary>Indice pour l’exercice</summary>
  <p>N’oubliez pas que l’élément <code>&lt;img&gt;</code> n’a pas de balise fermante.</p>
</details>
<details>
  <summary>Afficher la solution</summary>
  <pre><code>&lt;img src="chat.jpg" alt="Un chat roux qui dort sur le rebord d’une fenêtre"&gt;</code></pre>
</details>
Aperçu

Définition et utilisation

#

L’élément <details> crée un widget de dépliage sans une seule ligne de JavaScript. Seul son premier élément <summary> est toujours visible, et le reste du contenu apparaît au clic ou après avoir appuyé sur Entrée ou sur la barre d’espace. C’est une bonne solution pour les FAQ, les indices d’exercices, les solutions à vérifier et les détails techniques.

L’attribut open détermine si la section est dépliée. Le navigateur l’ajoute et le retire à chaque clic, et vous pouvez le définir dans le code pour que la section soit ouverte dès le départ. Chaque changement d’état déclenche l’événement toggle.

Plusieurs éléments <details> ayant le même attribut name forment un accordéon : l’ouverture d’une section ferme automatiquement les autres. Les lecteurs d’écran annoncent <summary> comme un bouton et indiquent si la section est dépliée ou repliée.

Syntaxe

#
Syntaxe
<details>
  <summary>Titre</summary>
  Contenu masqué…
</details>

Attributs

#
  • open

    attribut booléen

    La section est dépliée. Définissez-le dans le code pour que le contenu soit visible immédiatement, par exemple dans la première question d’une FAQ.
  • name

    texte

    Regroupe plusieurs éléments <details> de sorte qu’un seul puisse être ouvert à la fois. Fonctionne dans tous les principaux navigateurs depuis 2024.

L’élément accepte aussi tous les attributs globaux, comme class, id, style ou hidden.

Attributs en pratique

#

open

attribut booléen

La section est dépliée. Définissez-le dans le code pour que le contenu soit visible immédiatement, par exemple dans la première question d’une FAQ.

HTML
<details open>
  <summary>Combien de temps étudier par jour ?</summary>
  <p>La régularité compte plus que la durée des séances. Une demi-heure par jour suffit pour commencer.</p>
</details>
Aperçu

name

texte

Regroupe plusieurs éléments <details> de sorte qu’un seul puisse être ouvert à la fois. Fonctionne dans tous les principaux navigateurs depuis 2024.

HTML
<details name="faq" open>
  <summary>Par où commencer l’apprentissage ?</summary>
  <p>Par le HTML et le CSS, car on voit tout de suite les résultats dans le navigateur.</p>
</details>
<details name="faq">
  <summary>Faut-il connaître l’anglais ?</summary>
  <p>Cela aide, mais ce n’est pas indispensable au début.</p>
</details>
<details name="faq">
  <summary>Sur quel ordinateur apprendre ?</summary>
  <p>N’importe quel ordinateur équipé d’un navigateur moderne suffit.</p>
</details>
Aperçu

CSS par défaut

#

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

CSS
details {
  display: block;
}
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

#
  • Ne cachez pas dans un <details> un contenu que tout le monde doit lire. Les sections repliées passent facilement inaperçues.
  • Vous pouvez lire et modifier l’état de la section en JavaScript via la propriété open, et réagir aux changements avec l’événement toggle.
  • Le navigateur gère lui-même le clavier et informe les lecteurs d’écran de l’état de la section. N’ajoutez pas de rôles personnalisés ni d’attribut aria-expanded à <summary>.

Entrées associées

#

Pratiquer dans les leçons

#

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