aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/css/caption-side/index.html
blob: 8dc73a5ca15f2bcdc25809a2d1f2eef6acdf6667 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
---
title: caption-side
slug: Web/CSS/caption-side
tags:
  - CSS
  - Propriété
  - Reference
translation_of: Web/CSS/caption-side
---
<div>{{CSSRef}}</div>

<p>La propriété <strong><code>caption-side</code></strong> permet de choisir l'emplacement de la légende d'un tableau (représentée par l'élément {{HTMLElement("caption")}} du tableau). Les valeurs sont relatives au mode d'écriture (cf. {{cssxref("writing-mode")}}) du tableau.</p>

<div>{{EmbedInteractiveExample("pages/css/caption-side.html")}}</div>

<p class="hidden">Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> et à envoyer une <em>pull request</em> !</p>

<h2 id="Syntaxe">Syntaxe</h2>

<pre class="brush: css no-line-numbers">/* Valeurs avec un mot-clé */
/* Valeurs directionnelles */
caption-side: top;
caption-side: bottom;

/* Valeurs non-standards */
caption-side: left;
caption-side: right;
caption-side: top-outside;
caption-side: bottom-outside;


/* Valeur globales */
caption-side: inherit;
caption-side: initial;
caption-side: unset;
</pre>

<h3 id="Valeurs">Valeurs</h3>

<dl>
 <dt><code>top</code></dt>
 <dd>Un mot-clé qui indique que la boîte de la légende doit être positionnée au-dessus du tableau.</dd>
 <dt><code>bottom</code></dt>
 <dd>Un mot-clé qui indique que la boîte de la légende doit être positionnée en-dessous du tableau.</dd>
 <dt><code>left</code> {{non-standard_inline}}</dt>
 <dd>Un mot-clé qui indique que la boîte de la légende doit être positionnée à gauche du tableau.<br>
 {{Note("Cette valeur a été proposée pour CSS 2, mais fut retirée avec la spécification CSS 2.1. Elle est non-standard.")}}</dd>
 <dt><code>right</code> {{non-standard_inline}}</dt>
 <dd>Un mot-clé qui indique que la boîte de la légende doit être positionnée à droite du tableau.<br>
 {{Note("Cette valeur a été proposée pour CSS 2, mais fut retirée avec la spécification CSS 2.1. Elle est non-standard.")}}</dd>
 <dt><code>top-outside</code> {{non-standard_inline}}</dt>
 <dd>Un mot-clé qui indique que la boîte de la légende doit être positionnée au-dessus du tableau sans que la largeur ou l'alignement horizontal soient liées à la disposition horizontale du tableau.<br>
 {{Note("La spécification CSS 2.1 note que la spécification CSS 2 a défini un autre comportement pour la valeur <code>top</code>, réintroduit avec cette valeur dans une future spécification.")}}</dd>
 <dt><code>bottom-outside</code> {{non-standard_inline}}</dt>
 <dd>Un mot-clé qui indique que la boîte de la légende doit être positionnée en-dessous du tableau sans que la largeur ou l'alignement horizontal soient liées à la disposition horizontale du tableau.<br>
 {{Note("La spécification CSS 2.1 note que la spécification CSS 2 a défini un autre comportement pour la valeur <code>bottom</code>, réintroduit avec cette valeur dans une future spécification.")}}</dd>
</dl>

<h3 id="Syntaxe_formelle">Syntaxe formelle</h3>

<pre class="syntaxbox">{{csssyntax}}</pre>

<h2 id="Exemples">Exemples</h2>

<h3 id="CSS">CSS</h3>

<pre class="brush:css">caption {
  caption-side: bottom;
}
</pre>

<h3 id="HTML">HTML</h3>

<pre class="brush: html">&lt;table&gt;
  &lt;caption&gt;Une légende&lt;/caption&gt;
  &lt;tr&gt;
    &lt;td&gt;Des données d'un tableau&lt;/td&gt;
    &lt;td&gt;Pfiou encore des données&lt;/td&gt;
  &lt;/tr&gt;
&lt;/table&gt;</pre>

<h3 id="Résultat">Résultat</h3>

<p>{{EmbedLiveSample("Exemples","300","300")}}</p>

<h2 id="Spécifications">Spécifications</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Spécification</th>
   <th scope="col">État</th>
   <th scope="col">Commentaires</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('CSS Logical Properties', '#caption-side', 'caption-side')}}</td>
   <td>{{Spec2('CSS Logical Properties')}}</td>
   <td>Les valeurs <code>top</code> et <code>bottom</code> sont désormais définies comme relatives à la valeur de <code>writing-mode</code>.</td>
  </tr>
  <tr>
   <td>{{SpecName('CSS2.1', 'tables.html#caption-position', 'caption-side')}}</td>
   <td>{{Spec2('CSS2.1')}}</td>
   <td>Définition initiale.</td>
  </tr>
 </tbody>
</table>

<p>{{cssinfo}}</p>

<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>

<div class="hidden">Ce tableau de compatibilité a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à envoyer une <em>pull request</em> sur <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a>.</div>

<p>{{Compat("css.properties.caption-side")}}</p>