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/caption/index.md | |
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/caption/index.md')
-rw-r--r-- | files/fr/web/html/element/caption/index.md | 155 |
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><caption></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><table></code></a> dont il doit être le premier descendant.</td> + <td> + Un élément + <a href="/fr/docs/Web/HTML/Element/table"><code><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><caption></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><caption></code> devrait être le premier élément enfant de l'élément parent <a href="/fr/docs/Web/HTML/Element/table"><code><table></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><table></code></a> (étant le parent de l'élément <code><caption></code>) n'est que l'unique descendant d'un élément <a href="/fr/docs/Web/HTML/Element/figure"><code><figure></code></a>, c'est l'élément <a href="/fr/docs/Web/HTML/Element/figcaption"><code><figcaption></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><caption></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"><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></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><caption></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). |