diff options
author | julieng <julien.gattelier@gmail.com> | 2021-10-13 07:13:08 +0200 |
---|---|---|
committer | SphinxKnight <SphinxKnight@users.noreply.github.com> | 2021-11-07 11:56:53 +0100 |
commit | dea9d1f019d9e14357c58cf18653df1ac779d9d8 (patch) | |
tree | d20318111821d4e935a6c53409240078c4f687e5 /files/fr/web/html/element/figure | |
parent | 8829a7c9eb82f180bac76ed5836aaef95be209a1 (diff) | |
download | translated-content-dea9d1f019d9e14357c58cf18653df1ac779d9d8.tar.gz translated-content-dea9d1f019d9e14357c58cf18653df1ac779d9d8.tar.bz2 translated-content-dea9d1f019d9e14357c58cf18653df1ac779d9d8.zip |
convert content to md
Diffstat (limited to 'files/fr/web/html/element/figure')
-rw-r--r-- | files/fr/web/html/element/figure/index.md | 186 |
1 files changed, 121 insertions, 65 deletions
diff --git a/files/fr/web/html/element/figure/index.md b/files/fr/web/html/element/figure/index.md index 9c53dbb174..b2c0cceea9 100644 --- a/files/fr/web/html/element/figure/index.md +++ b/files/fr/web/html/element/figure/index.md @@ -12,83 +12,136 @@ tags: translation_of: Web/HTML/Element/figure browser-compat: html.elements.figure --- -<div>{{HTMLRef}}</div> +{{HTMLRef}} -<p>L'élément HTML <strong><code><figure></code></strong> représente un contenu autonome, éventuellement accompagné d'une légende facultative, qui est spécifiée à l'aide de l'élément <a href="/fr/docs/Web/HTML/Element/figcaption"><code><figcaption></code></a>. La figure, sa légende et son contenu sont référencés comme une seule unité.</p> +L'élément HTML **`<figure>`** représente un contenu autonome, éventuellement accompagné d'une légende facultative, qui est spécifiée à l'aide de l'élément [`<figcaption>`](/fr/docs/Web/HTML/Element/figcaption). La figure, sa légende et son contenu sont référencés comme une seule unité. -<div>{{EmbedInteractiveExample("pages/tabbed/figure.html","tabbed-shorter")}}</div> +{{EmbedInteractiveExample("pages/tabbed/figure.html","tabbed-shorter")}} <table class="properties"> <tbody> <tr> - <th scope="row"><a href="/fr/docs/Web/Guide/HTML/Content_categories">Catégories de contenu</a></th> - <td><a href="/fr/docs/Web/Guide/HTML/Content_categories#flow_content">Contenu de flux</a>, <a href="/fr/docs/Web/Guide/HTML/Using_HTML_sections_and_outlines#sectioning_roots">racine de sectionnement</a>, <a href="/fr/docs/Web/Guide/HTML/Content_categories#palpable_content">contenu tangible</a>.</td> + <th scope="row"> + <a href="/fr/docs/Web/Guide/HTML/Content_categories" + >Catégories de contenu</a + > + </th> + <td> + <a href="/fr/docs/Web/Guide/HTML/Content_categories#flow_content" + >Contenu de flux</a + >, + <a + href="/fr/docs/Web/Guide/HTML/Using_HTML_sections_and_outlines#sectioning_roots" + >racine de sectionnement</a + >, + <a href="/fr/docs/Web/Guide/HTML/Content_categories#palpable_content" + >contenu tangible</a + >. + </td> </tr> <tr> <th scope="row">Contenu autorisé</th> - <td>Un élément <a href="/fr/docs/Web/HTML/Element/figcaption"><code><figcaption></code></a> suivi d'un <a href="/fr/docs/Web/Guide/HTML/Content_categories#flow_content">contenu de flux</a> ou du contenu de flux suivi d'un élément <a href="/fr/docs/Web/HTML/Element/figcaption"><code><figcaption></code></a> ou du contenu de flux.</td> + <td> + Un élément + <a href="/fr/docs/Web/HTML/Element/figcaption" + ><code><figcaption></code></a + > + suivi d'un + <a href="/fr/docs/Web/Guide/HTML/Content_categories#flow_content" + >contenu de flux</a + > + ou du contenu de flux suivi d'un élément + <a href="/fr/docs/Web/HTML/Element/figcaption" + ><code><figcaption></code></a + > + ou du contenu de flux. + </td> </tr> <tr> <th scope="row">Omission de balises</th> - <td>Aucune, la balise ouvrante et la balise fermante sont toutes les deux obligatoires.</td> + <td> + Aucune, la balise ouvrante et la balise fermante sont toutes les deux + obligatoires. + </td> </tr> <tr> <th scope="row">Parents autorisés</th> - <td>Tout élément qui accepte du <a href="/fr/docs/Web/Guide/HTML/Content_categories#flow_content">contenu de flux</a>.</td> + <td> + Tout élément qui accepte du + <a href="/fr/docs/Web/Guide/HTML/Content_categories#flow_content" + >contenu de flux</a + >. + </td> </tr> <tr> <th scope="row">Rôle ARIA implicite</th> - <td><a href="/fr/docs/Web/Accessibility/ARIA/Roles/Figure_Role"><code>figure</code></a></td> + <td> + <a href="/fr/docs/Web/Accessibility/ARIA/Roles/Figure_Role" + ><code>figure</code></a + > + </td> </tr> <tr> <th scope="row">Rôles ARIA autorisés</th> - <td>Sans descendant <a href="/fr/docs/Web/HTML/Element/figcaption"><code><figcaption></code></a> descendant : <a href="https://www.w3.org/TR/html-aria/#dfn-any-role">n'importe quel rôle</a>, sinon aucun rôle autorisé.</td> + <td> + Sans descendant + <a href="/fr/docs/Web/HTML/Element/figcaption" + ><code><figcaption></code></a + > + descendant : + <a href="https://www.w3.org/TR/html-aria/#dfn-any-role" + >n'importe quel rôle</a + >, sinon aucun rôle autorisé. + </td> </tr> <tr> <th scope="row">Interface DOM</th> - <td><a href="/fr/docs/Web/API/HTMLElement"><code>HTMLElement</code></a></td> + <td> + <a href="/fr/docs/Web/API/HTMLElement"><code>HTMLElement</code></a> + </td> </tr> </tbody> </table> -<h2 id="attributes">Attributs</h2> +## Attributs -<p>Cet élément prend uniquement en charge <a href="/fr/docs/Web/HTML/Global_attributes">les attributs universels</a>.</p> +Cet élément prend uniquement en charge [les attributs universels](/fr/docs/Web/HTML/Global_attributes). -<h2 id="usage_notes">Notes d'utilisation</h2> +## Notes d'utilisation -<ul> - <li>Généralement, un élément <code><figure></code> est utilisé pour une image, une illustration, un diagramme, un fragment de code ou autre qui est référencé depuis le flux principal du document. Toutefois, cet élément peut être déplacé vers une autre partie du document ou en annexe sans que cela ait un impact sur le flux principal.</li> - <li><code><figure></code> est <a href="/fr/docs/Web/Guide/HTML/Using_HTML_sections_and_outlines#sectioning_roots">une racine de sectionnement</a>, son contenu est donc exclu du plan général du document.</li> - <li>Une légende peut être associée avec l'élément <code><figure></code> en insérant un élément <a href="/fr/docs/Web/HTML/Element/figcaption"><code><figcaption></code></a> à l'intérieur (en premier ou dernier élément enfant). C'est le premier élément <code><figcaption></code> qui sera trouvé dans la figure qui sera affiché comme légende.</li> -</ul> +- Généralement, un élément `<figure>` est utilisé pour une image, une illustration, un diagramme, un fragment de code ou autre qui est référencé depuis le flux principal du document. Toutefois, cet élément peut être déplacé vers une autre partie du document ou en annexe sans que cela ait un impact sur le flux principal. +- `<figure>` est [une racine de sectionnement](/fr/docs/Web/Guide/HTML/Using_HTML_sections_and_outlines#sectioning_roots), son contenu est donc exclu du plan général du document. +- Une légende peut être associée avec l'élément `<figure>` en insérant un élément [`<figcaption>`](/fr/docs/Web/HTML/Element/figcaption) à l'intérieur (en premier ou dernier élément enfant). C'est le premier élément `<figcaption>` qui sera trouvé dans la figure qui sera affiché comme légende. -<h2 id="examples">Exemples</h2> +## Exemples -<h3 id="images">Images</h3> +### Images -<pre class="brush: html"><!-- Une simple image --> -<figure> - <img +```html +<!-- Une simple image --> +<figure> + <img src="https://developer.mozilla.org/static/img/favicon144.png" - alt="Le logo de MDN."> -</figure> + alt="Le logo de MDN."> +</figure> -<!-- Une image avec une légende --> -<figure> - <img +<!-- Une image avec une légende --> +<figure> + <img src="https://developer.mozilla.org/static/img/favicon144.png" - alt="Le logo de MDN."> - <figcaption>Logo MDN</figcaption> -</figure></pre> + alt="Le logo de MDN."> + <figcaption>Logo MDN</figcaption> +</figure> +``` -<div>{{EmbedLiveSample("images", "100%", 400)}}</div> +{{EmbedLiveSample("images", "100%", 400)}} -<h3 id="code_snippets">Extrait de code</h3> +### Extrait de code -<pre class="brush: html"><figure> - <figcaption>Obtenir les détails du navigateur</figcaption> - <pre> +```html +<figure> + <figcaption>Obtenir les détails du navigateur</figcaption> + <pre> function NavigatorExample(){ let txt; txt = "Nom de code: " + navigator.appCodeName; @@ -99,51 +152,54 @@ browser-compat: html.elements.figure txt += "En-tête d'agent utilisateur : " + navigator.userAgent; console.log("NavigatorExample", txt); } - </pre> -</figure></pre> + </pre> +</figure> +``` -<div>{{EmbedLiveSample("code_snippets", "100%", 250)}}</div> +{{EmbedLiveSample("code_snippets", "100%", 250)}} -<h3 id="quotations">Citation</h3> +### Citation -<pre class="brush: html"><figure> - <figcaption> - <cite>Edsger Dijkstra : </cite> - </figcaption> - <p>« Si le débogage correspond au retrait de bogues, +```html +<figure> + <figcaption> + <cite>Edsger Dijkstra : </cite> + </figcaption> + <p>« Si le débogage correspond au retrait de bogues, alors la programmation correspond à l'ajout de bogues. » - </p> -</figure></pre> + </p> +</figure> +``` -<div>{{EmbedLiveSample("quotations","", 150)}}</div> +{{EmbedLiveSample("quotations","", 150)}} -<h3 id="poems">Poème</h3> +### Poème -<pre class="brush: html"><figure> - <p style="white-space:pre"> +```html +<figure> + <p style="white-space:pre"> Bid me discourse, I will enchant thine ear, Or like a fairy trip upon the green, Or, like a nymph, with long dishevell'd hair, Dance on the sands, and yet no footing seen: Love is a spirit all compact of fire, Not gross to sink, but light, and will aspire. - </p> - <figcaption><cite>Venus and Adonis</cite>. - By: William Shakespeare</figcaption> -</figure></pre> + </p> + <figcaption><cite>Venus and Adonis</cite>. + By: William Shakespeare</figcaption> +</figure> +``` -<div>{{EmbedLiveSample("poems", "100%", 260)}}</div> +{{EmbedLiveSample("poems", "100%", 260)}} -<h2 id="specifications">Spécifications</h2> +## Spécifications -<p>{{Specifications}}</p> +{{Specifications}} -<h2 id="browser_compatibility">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat}}</p> +{{Compat}} -<h2 id="see_also">Voir aussi</h2> +## Voir aussi -<ul> - <li>L'élément <a href="/fr/docs/Web/HTML/Element/figcaption"><code><figcaption></code></a></li> -</ul> +- L'élément [`<figcaption>`](/fr/docs/Web/HTML/Element/figcaption) |