From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/fr/web/html/element/details/index.html | 265 +++++++++++++++++++++++++++ 1 file changed, 265 insertions(+) create mode 100644 files/fr/web/html/element/details/index.html (limited to 'files/fr/web/html/element/details/index.html') diff --git a/files/fr/web/html/element/details/index.html b/files/fr/web/html/element/details/index.html new file mode 100644 index 0000000000..70797fa6b9 --- /dev/null +++ b/files/fr/web/html/element/details/index.html @@ -0,0 +1,265 @@ +--- +title:
+slug: Web/HTML/Element/details +tags: + - Element + - HTML + - Reference + - Web +translation_of: Web/HTML/Element/details +--- +
{{HTMLRef}}
+ +

L'élément HTML <details> est utilisé comme un outil permettant de révéler une information. Un résumé ou un intitulé peuvent être fournis grâce à un élément {{HTMLElement("summary")}}.

+ +

La plupart du temps, le contrôle utilisé pour cet élément est un triangle qui est tourné ou tordu afin d'indiquer si l'élément est révélé ou non. Si le premier élément fils de l'élément <details> est un élément <summary>, c'est le contenu de ce dernier qui est utilisé comme intitulé pour le contenu à révéler (l'intitulé est donc toujours visible).

+ +
{{EmbedInteractiveExample("pages/tabbed/details.html", "tabbed-standard")}}
+ + + +

Attributs

+ +

Comme tous les éléments HTML, cet élément accepte les attributs universels.

+ +
+
{{htmlattrdef("open")}}
+
Cet attribut booléen indique si les détails seront affichés lors du chargement de la page. La valeur par défaut est false (les détails sont alors cachés).
+
+ +

Évènement toggle

+ +

En plus des évènements classiques pris en charge par les éléments HTML, l'élément <details> prend en charge l'évènement {{event("toggle")}} qui est envoyé sur l'élément lorsque son état change entre ouvert et fermé (que ce soit dans un sens ou dans l'autre). L'évènement est envoyé après que l'état ait été changé et si plusieurs changement d'état ont eu lieu avant que le navigateur envoie l'évènement, le navigateur fusionnera ces évènements en un seul.

+ +

On peut alors écouter cet évènement en JavaScript afin de détecter le changement d'état du contrôle :

+ +
detailsElem.addEventListener("toggle", function(evt){
+  if(detailsElem.open) {
+    /* l'état est passé en "ouvert" */
+  } else {
+    /* l'état est passé en "fermé" */
+  }
+}, false);
+ +

Exemples

+ +

Un exemple simple

+ +

Dans cet exemple, on utilise un élément <details> sans résumé/intitulé.

+ +

HTML

+ +
<details>
+  <p>Requires a computer running an operating system. The computer
+  must have some memory and ideally some kind of long-term storage.
+  An input device as well as some form of output device is
+  recommended.</p>
+</details>
+ +

Ici, le navigateur utilisera alors un intitulé par défaut (généralement, ce sera "Détails").

+ +

Résultat

+ +

{{EmbedLiveSample("Un_exemple_simple", 650, 150)}}

+ +

Fournir un résumé

+ +

Dans cet exemple, on ajoute un résumé grâce à l'élément {{HTMLElement("summary")}} qu'on imbrique au début de l'élément <details> :

+ +

HTML

+ +
<details>
+  <summary>System Requirements</summary>
+  <p>Requires a computer running an operating system. The computer
+  must have some memory and ideally some kind of long-term storage.
+  An input device as well as some form of output device is
+  recommended.</p>
+</details>
+ +

Résultat

+ +

{{EmbedLiveSample("Fournir_un_résumé", 650, 150)}}

+ +

Créer un contrôle déja ouvert

+ +

Pour obtenir une boîte <details> dans un état ouvert, il suffit d'ajouter l'attribut booléen open :

+ +

HTML

+ +
<details open>
+  <summary>System Requirements</summary>
+  <p>Requires a computer running an operating system. The computer
+  must have some memory and ideally some kind of long-term storage.
+  An input device as well as some form of output device is
+  recommended.</p>
+</details>
+ +

Résultat

+ +

{{EmbedLiveSample("Créer_un_contrôle_déja_ouvert", 650, 150)}}

+ +

Personnaliser l’apparence

+ +

Utilisons un peu de CSS afin de personnaliser l'apparence du contrôle fourni par <details>.

+ +

CSS

+ +
details {
+  font: 16px "Open Sans", "Arial", sans-serif;
+  width: 620px;
+}
+
+details > summary {
+  padding: 2px 6px;
+  width: 15em;
+  background-color: #ddd;
+  border: none;
+  box-shadow: 3px 3px 4px black;
+}
+
+details > p {
+  border-radius: 0 0 10px 10px;
+  background-color: #ddd;
+  padding: 2px 6px;
+  margin: 0;
+  box-shadow: 3px 3px 4px black;
+}
+
+ +

Ce fragment de feuille de style CSS crée une apparence similaire à un onglet où, lorsqu'on clique sur l'onglet, il s'étend et révèle le contenu.

+ +

HTML

+ +
<details>
+  <summary>System Requirements</summary>
+  <p>Requires a computer running an operating system. The computer
+  must have some memory and ideally some kind of long-term storage.
+  An input device as well as some form of output device is
+  recommended.</p>
+</details>
+ +

Résultat

+ +

{{EmbedLiveSample("Personnaliser_l’apparence", 650, 150)}}

+ +

Personnaliser le marqueur de révélation

+ +

Le triangle généralement utilisé peut également être personnalisé. Toutefois, cette fonctionnalité a été standardisée récemment et n'est pas encore largement prise en charge. De plus, la méthode de prise en charge varie encore d'un navigateur à un autre.

+ +

L'élément {{HTMLElement("summary")}} permet d'utiliser la propriété raccourcie {{cssxref("list-style")}} ainsi que les propriétés détaillées associées (telle que {{cssxref("list-style-type")}}) afin de modifier l'icône utilisée pour le contrôle.

+ +

Il est possible de retirer l'icône en utilisant la valeur none pour la propriété list-style. Il est aussi possible d'utiliser d'autres valeurs sur list-style afin de configurer l'apparence du contrôle.

+ +

Actuellement, Chrome ne prend pas en charge cette fonctionnalité et il faut utiliser le pseudo-élément spécifique ::-webkit-details-marker afin de personnaliser l'apparence.

+ +

Pour une meilleure compatibilité à court terme, vous pouvez utiliser display: none sur l'élément <summary> afin de désactiver l'affichage du contrôle.

+ +

CSS

+ +
details {
+  font: 16px "Open Sans", "Arial", sans-serif;
+  width: 620px;
+}
+
+details > summary {
+  padding: 2px 6px;
+  width: 15em;
+  background-color: #ddd;
+  border: none;
+  box-shadow: 3px 3px 4px black;
+  list-style: none;
+}
+
+details > summary::-webkit-details-marker {
+  display: none;
+}
+
+details > p {
+  border-radius: 0 0 10px 10px;
+  background-color: #ddd;
+  padding: 2px 6px;
+  margin: 0;
+  box-shadow: 3px 3px 4px black;
+}
+
+ +

HTML

+ +
<details>
+  <summary>System Requirements</summary>
+  <p>Requires a computer running an operating system. The computer
+  must have some memory and ideally some kind of long-term storage.
+  An input device as well as some form of output device is
+  recommended.</p>
+</details>
+ +

Résultat

+ +

{{EmbedLiveSample("Personnaliser_le_marqueur_de_révélation", 650, 150)}}

+ +

Résumé technique

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Catégories de contenuContenu de flux, racine de section, contenu interactif, contenu tangible.
Contenu autoriséUn élément {{HTMLElement("summary")}} suivi par du contenu de flux.
Omission de balises{{no_tag_omission}}
Parents autorisésTout élément acceptant du contenu de flux.
Rôles ARIA autorisésAucun.
Interface DOM{{domxref("HTMLDetailsElement")}}
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + + + +
SpécificationÉtatCommentaires
{{SpecName('HTML WHATWG', 'interactive-elements.html#the-details-element', '<details>')}}{{Spec2('HTML WHATWG')}}
{{SpecName('HTML5.1', 'interactive-elements.html#the-details-element', '<details>')}}{{Spec2('HTML5.1')}}Définition initiale.
+ +

Compatibilité des navigateurs

+ + + +

{{Compat("html.elements.details")}}

+ +

Voir aussi

+ + -- cgit v1.2.3-54-g00ecf