aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/css/caption-side/index.md
blob: 1c6448b38c4304a792b9b6b3cd2cad763a68a120 (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
---
title: caption-side
slug: Web/CSS/caption-side
tags:
  - CSS
  - Propriété
  - Reference
translation_of: Web/CSS/caption-side
---
{{CSSRef}}

La propriété **`caption-side`** 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.

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

## Syntaxe

```css
/* 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;
```

### Valeurs

- `top`
  - : Un mot-clé qui indique que la boîte de la légende doit être positionnée au-dessus du tableau.
- `bottom`
  - : Un mot-clé qui indique que la boîte de la légende doit être positionnée en-dessous du tableau.
- `left` {{non-standard_inline}}
  - : Un mot-clé qui indique que la boîte de la légende doit être positionnée à gauche du tableau.
    {{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.")}}
- `right` {{non-standard_inline}}
  - : Un mot-clé qui indique que la boîte de la légende doit être positionnée à droite du tableau.
    {{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.")}}
- `top-outside` {{non-standard_inline}}
  - : 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.
    {{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.")}}
- `bottom-outside` {{non-standard_inline}}
  - : 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.
    {{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.")}}

### Syntaxe formelle

{{csssyntax}}

## Exemples

### CSS

```css
caption {
  caption-side: bottom;
}
```

### HTML

```html
<table>
  <caption>Une légende</caption>
  <tr>
    <td>Des données d'un tableau</td>
    <td>Pfiou encore des données</td>
  </tr>
</table>
```

### Résultat

{{EmbedLiveSample("Exemples","300","300")}}

## Spécifications

| Spécification                                                                                    | État                                             | Commentaires                                                                                         |
| ------------------------------------------------------------------------------------------------ | ------------------------------------------------ | ---------------------------------------------------------------------------------------------------- |
| {{SpecName('CSS Logical Properties', '#caption-side', 'caption-side')}} | {{Spec2('CSS Logical Properties')}} | Les valeurs `top` et `bottom` sont désormais définies comme relatives à la valeur de `writing-mode`. |
| {{SpecName('CSS2.1', 'tables.html#caption-position', 'caption-side')}}     | {{Spec2('CSS2.1')}}                         | Définition initiale.                                                                                 |

{{cssinfo}}

## Compatibilité des navigateurs

{{Compat("css.properties.caption-side")}}