aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/html/element/caption/index.md
diff options
context:
space:
mode:
authorjulieng <julien.gattelier@gmail.com>2021-10-13 07:13:08 +0200
committerSphinxKnight <SphinxKnight@users.noreply.github.com>2021-11-07 11:56:53 +0100
commitdea9d1f019d9e14357c58cf18653df1ac779d9d8 (patch)
treed20318111821d4e935a6c53409240078c4f687e5 /files/fr/web/html/element/caption/index.md
parent8829a7c9eb82f180bac76ed5836aaef95be209a1 (diff)
downloadtranslated-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/caption/index.md')
-rw-r--r--files/fr/web/html/element/caption/index.md155
1 files changed, 86 insertions, 69 deletions
diff --git a/files/fr/web/html/element/caption/index.md b/files/fr/web/html/element/caption/index.md
index 00a70e2d0c..d45202a5de 100644
--- a/files/fr/web/html/element/caption/index.md
+++ b/files/fr/web/html/element/caption/index.md
@@ -15,33 +15,52 @@ tags:
translation_of: Web/HTML/Element/caption
browser-compat: html.elements.caption
---
-<div>{{HTMLRef}}</div>
+{{HTMLRef}}
-<p>L'élément <strong><code>&lt;caption&gt;</code></strong> définit la légende (ou le titre) d'un tableau.</p>
+L'élément **`<caption>`** définit la légende (ou le titre) d'un tableau.
-<div>{{EmbedInteractiveExample("pages/tabbed/caption.html", "tabbed-standard")}}</div>
+{{EmbedInteractiveExample("pages/tabbed/caption.html", "tabbed-standard")}}
<table class="properties">
<tbody>
<tr>
- <th scope="row"><a href="/fr/docs/Web/Guide/HTML/Content_categories">Catégories de contenu</a></th>
+ <th scope="row">
+ <a href="/fr/docs/Web/Guide/HTML/Content_categories"
+ >Catégories de contenu</a
+ >
+ </th>
<td>Aucune.</td>
</tr>
<tr>
<th scope="row">Contenu autorisé</th>
- <td><a href="/fr/docs/Web/Guide/HTML/Content_categories#flow_content">Contenu de flux</a>.</td>
+ <td>
+ <a href="/fr/docs/Web/Guide/HTML/Content_categories#flow_content"
+ >Contenu de flux</a
+ >.
+ </td>
</tr>
<tr>
<th scope="row">Omission de balises</th>
- <td>La balise de fin peut être absente si l'élément n'est pas immédiatement suivi d'un blanc ASCII ou d'un commentaire.</td>
+ <td>
+ La balise de fin peut être absente si l'élément n'est pas immédiatement
+ suivi d'un blanc ASCII ou d'un commentaire.
+ </td>
</tr>
<tr>
<th scope="row">Parents autorisés</th>
- <td>Un élément <a href="/fr/docs/Web/HTML/Element/table"><code>&lt;table&gt;</code></a> dont il doit être le premier descendant.</td>
+ <td>
+ Un élément
+ <a href="/fr/docs/Web/HTML/Element/table"><code>&#x3C;table></code></a>
+ dont il doit être le premier descendant.
+ </td>
</tr>
<tr>
<th scope="row">Rôle ARIA implicite</th>
- <td><a href="https://www.w3.org/TR/html-aria/#dfn-no-corresponding-role">Pas de rôle correspondant</a></td>
+ <td>
+ <a href="https://www.w3.org/TR/html-aria/#dfn-no-corresponding-role"
+ >Pas de rôle correspondant</a
+ >
+ </td>
</tr>
<tr>
<th scope="row">Rôles ARIA autorisés</th>
@@ -49,68 +68,70 @@ browser-compat: html.elements.caption
</tr>
<tr>
<th scope="row">Interface DOM</th>
- <td><a href="/fr/docs/Web/API/HTMLTableCaptionElement"><code>HTMLTableCaptionElement</code></a></td>
+ <td>
+ <a href="/fr/docs/Web/API/HTMLTableCaptionElement"
+ ><code>HTMLTableCaptionElement</code></a
+ >
+ </td>
</tr>
</tbody>
</table>
-<h2 id="attributes">Attributs</h2>
+## Attributs
-<p>On peut utiliser<a href="/fr/docs/Web/HTML/Global_attributes"> les attributs universels</a> sur cet élément.</p>
+On peut utiliser[ les attributs universels](/fr/docs/Web/HTML/Global_attributes) sur cet élément.
-<h3 id="deprecated_attributes">Attributs obsolètes</h3>
+### Attributs obsolètes
-<dl>
- <dt><strong><code>align</code></strong> {{deprecated_inline}}</dt>
- <dd>Cet attribut à valeur contrainte indique l'alignement de la légende du tableau par rapport au tableau lui-même. Il peut valoir :
- <dl>
- <dt><code>left</code></dt>
- <dd>La légende est affichée à gauche du tableau</dd>
- <dt><code>top</code></dt>
- <dd>La légende est affichée au-dessus du tableau</dd>
- <dt><code>right</code></dt>
- <dd>La légende est affichée à droite du tableau</dd>
- <dt><code>bottom</code></dt>
- <dd>La légende est affichée en dessous du tableau</dd>
- </dl>
+- **`align`** {{deprecated_inline}}
- <div class="note">
- <p><strong>Note :</strong> Ne pas utiliser cet attribut. Il a été déprécié. L'élément <code>&lt;caption&gt;</code> devrait être mis en forme grâce au <a href="/fr/docs/Web/CSS">CSS</a>. Afin d'obtenir des effets similaires à cet attribut, on utilisera les propriétés CSS <a href="/fr/docs/Web/CSS/caption-side"><code>caption-side</code></a> et <a href="/fr/docs/Web/CSS/text-align"><code>text-align</code></a>.</p>
- </div>
- </dd>
-</dl>
+ - : Cet attribut à valeur contrainte indique l'alignement de la légende du tableau par rapport au tableau lui-même. Il peut valoir :
-<h2 id="usage_notes">Notes d'utilisation</h2>
+ - `left`
+ - : La légende est affichée à gauche du tableau
+ - `top`
+ - : La légende est affichée au-dessus du tableau
+ - `right`
+ - : La légende est affichée à droite du tableau
+ - `bottom`
+ - : La légende est affichée en dessous du tableau
-<p>L'élément <code>&lt;caption&gt;</code> devrait être le premier élément enfant de l'élément parent <a href="/fr/docs/Web/HTML/Element/table"><code>&lt;table&gt;</code></a>.</p>
+ > **Note :** Ne pas utiliser cet attribut. Il a été déprécié. L'élément `<caption>` devrait être mis en forme grâce au [CSS](/fr/docs/Web/CSS). Afin d'obtenir des effets similaires à cet attribut, on utilisera les propriétés CSS [`caption-side`](/fr/docs/Web/CSS/caption-side) et [`text-align`](/fr/docs/Web/CSS/text-align).
-<p>Quand l'élément <a href="/fr/docs/Web/HTML/Element/table"><code>&lt;table&gt;</code></a> (étant le parent de l'élément <code>&lt;caption&gt;</code>) n'est que l'unique descendant d'un élément <a href="/fr/docs/Web/HTML/Element/figure"><code>&lt;figure&gt;</code></a>, c'est l'élément <a href="/fr/docs/Web/HTML/Element/figcaption"><code>&lt;figcaption&gt;</code></a> doit être utilisé.</p>
+## Notes d'utilisation
-<p>Utiliser la propriété <a href="/fr/docs/Web/CSS/background-color"><code>background-color</code></a> sur le tableau ne modifiera pas l'apparence de la légende. Il est également nécessaire d'ajouter une déclaration CSS avec <code>background-color</code> sur l'élément <code>&lt;caption&gt;</code> pour que celui-ci ait la même couleur.</p>
+L'élément `<caption>` devrait être le premier élément enfant de l'élément parent [`<table>`](/fr/docs/Web/HTML/Element/table).
-<h2 id="Exemple">Exemple</h2>
+Quand l'élément [`<table>`](/fr/docs/Web/HTML/Element/table) (étant le parent de l'élément `<caption>`) n'est que l'unique descendant d'un élément [`<figure>`](/fr/docs/Web/HTML/Element/figure), c'est l'élément [`<figcaption>`](/fr/docs/Web/HTML/Element/figcaption) doit être utilisé.
-<p>Cet exemple simple présente un tableau qui comprend une légende.</p>
+Utiliser la propriété [`background-color`](/fr/docs/Web/CSS/background-color) sur le tableau ne modifiera pas l'apparence de la légende. Il est également nécessaire d'ajouter une déclaration CSS avec `background-color` sur l'élément `<caption>` pour que celui-ci ait la même couleur.
-<h3 id="html">HTML</h3>
+## Exemple
-<pre class="brush: html">&lt;table&gt;
- &lt;caption&gt;Légende de l'exemple&lt;/caption&gt;
- &lt;tr&gt;
- &lt;th&gt;Connexion&lt;/th&gt;
- &lt;th&gt;Courriel :&lt;/th&gt;
- &lt;/tr&gt;
- &lt;tr&gt;
- &lt;td&gt;utilisateur1&lt;/td&gt;
- &lt;td&gt;utilisateur1@test.fr&lt;/td&gt;
- &lt;/tr&gt;
- &lt;tr&gt;
- &lt;td&gt;utilisateur2&lt;/td&gt;
- &lt;td&gt;utilisateur2@test.fr&lt;/td&gt;
- &lt;/tr&gt;
-&lt;/table&gt;</pre>
+Cet exemple simple présente un tableau qui comprend une légende.
-<pre class="brush: css hidden">caption {
+### HTML
+
+```html
+<table>
+ <caption>Légende de l'exemple</caption>
+ <tr>
+ <th>Connexion</th>
+ <th>Courriel :</th>
+ </tr>
+ <tr>
+ <td>utilisateur1</td>
+ <td>utilisateur1@test.fr</td>
+ </tr>
+ <tr>
+ <td>utilisateur2</td>
+ <td>utilisateur2@test.fr</td>
+ </tr>
+</table>
+```
+
+```css hidden
+caption {
caption-side: top;
}
table {
@@ -120,27 +141,23 @@ browser-compat: html.elements.caption
table, th, td {
border: 1px solid black;
}
-</pre>
+```
+
+### Résultat
-<h3 id="result">Résultat</h3>
+{{EmbedLiveSample('Exemple', '', 120)}}
-<p>{{EmbedLiveSample('Exemple', '', 120)}}</p>
+## Spécifications
-<h2 id="specifications">Spécifications</h2>
+{{Specifications}}
-<p>{{Specifications}}</p>
+## Compatibilité des navigateurs
-<h2 id="browser_compatibility">Compatibilité des navigateurs</h2>
+{{Compat}}
-<p>{{Compat}}</p>
+## Voir aussi
-<h2 id="see_also">Voir aussi</h2>
+- Les propriétés CSS particulièrement utiles pour styliser l'élément `<caption>` :
-<ul>
- <li>Les propriétés CSS particulièrement utiles pour styliser l'élément <code>&lt;caption&gt;</code> :
- <ul>
- <li><a href="/fr/docs/Web/CSS/text-align"><code>text-align</code></a></li>
- <li><a href="/fr/docs/Web/CSS/caption-side"><code>caption-side</code></a>.</li>
- </ul>
- </li>
- </ul>
+ - [`text-align`](/fr/docs/Web/CSS/text-align)
+ - [`caption-side`](/fr/docs/Web/CSS/caption-side).