aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/css/_colon_first/index.md
blob: 72ad3d0e0251e4935b841d1143d81cfdaac8055b (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
---
title: ':first'
slug: Web/CSS/:first
tags:
  - CSS
  - Pseudo-classe
  - Reference
translation_of: Web/CSS/:first
---
{{CSSRef}}

La pseudo-classe **`:first`**, liée à la règle @ {{cssxref("@page")}} décrit la mise en forme de la première page lors de l'impression d'un document. ( voir {{cssxref(":first-child")}} pour le premier élément d'un noeud )

```css
/* Cible le contenu de la première page */
/* lorsqu'on imprime */
@page :first {
  margin-left: 50%;
  margin-top: 50%;
}
```

Seul un sous-ensemble restreint de propriétés peut être modifié via cette pseudo-classe :

- Les propriétés liées aux marges : {{cssxref("margin")}}
- Les propriétés liées aux lignes veuves et orphelines : {{cssxref("orphans")}} et {{cssxref("widows")}}
- Les propriétés liées aux sauts de page : {{cssxref("page-break")}}

De plus, seules [les unités absolues](/fr/docs/Web/CSS/length#unités_de_longueur_absolues) peuvent être utilisées pour les marges.

## Syntaxe

{{csssyntax}}

## Exemples

### CSS

```css
@page :first {
  margin-left: 50%;
  margin-top: 50%;
}

p {
  page-break-after: always;
}
```

### HTML

```html
<p>Première page.</p>
<p>Deuxième page.</p>
<button>Imprimer</button>
```

### JavaScript

```js
document.querySelector("button").addEventListener('click', () => {
  window.print();
});
```

Appuyez sur le bouton "Imprimer!" pour imprimer l'exemple. Les mots sur la première page doivent être quelque part autour du centre, tandis que les autres pages auront leur contenu à la position par défaut.

{{EmbedLiveSample("Exemples","80%","150px")}}

## Spécifications

| Spécification                                                                        | État                                     | Commentaires         |
| ------------------------------------------------------------------------------------ | ---------------------------------------- | -------------------- |
| {{SpecName('CSS3 Paged Media', '#left-right-first', ':first')}} | {{Spec2('CSS3 Paged Media')}} | Aucune modification. |
| {{SpecName('CSS2.1', 'page.html#page-selectors', ':first')}}     | {{Spec2('CSS2.1')}}                 | Définition initiale. |

## Compatibilité des navigateurs

{{Compat("css.selectors.first")}}

## Voir aussi

- {{cssxref("@page")}}
- {{cssxref(":left")}}
- {{cssxref(":right")}}