<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
Exemple
#<details>
<summary>Indice pour l’exercice</summary>
<p>N’oubliez pas que l’élément <code><img></code> n’a pas de balise fermante.</p>
</details>
<details>
<summary>Afficher la solution</summary>
<pre><code><img src="chat.jpg" alt="Un chat roux qui dort sur le rebord d’une fenêtre"></code></pre>
</details>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
#<details>
<summary>Titre</summary>
Contenu masqué…
</details>Attributs
#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.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éenLa 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.
<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>name
texteRegroupe plusieurs éléments <details> de sorte qu’un seul puisse être ouvert à la fois. Fonctionne dans tous les principaux navigateurs depuis 2024.
<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>CSS par défaut
#La plupart des navigateurs affichent cet élément avec ces styles par défaut :
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énementtoggle. - 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
#- <summary>Le titre toujours visible d’un élément `<details>`, qui déplie et replie le contenu.
- <dialog>Une boîte de dialogue ou fenêtre modale : confirmation, formulaire ou message affiché au-dessus du reste de la page.
- <section>Une partie thématique d’un document, généralement avec son propre titre.
- <button>Un bouton cliquable : il envoie un formulaire, le réinitialise, ou lance une action sur la page.
Pratiquer dans les leçons
#Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.