diff options
Diffstat (limited to 'files/fr/web/css/@page/index.md')
| -rw-r--r-- | files/fr/web/css/@page/index.md | 127 |
1 files changed, 51 insertions, 76 deletions
diff --git a/files/fr/web/css/@page/index.md b/files/fr/web/css/@page/index.md index 9d44d62546..563e341e7e 100644 --- a/files/fr/web/css/@page/index.md +++ b/files/fr/web/css/@page/index.md @@ -7,99 +7,74 @@ tags: - Règle @ translation_of: Web/CSS/@page --- -<div>{{CSSRef}}</div> +{{CSSRef}} -<p>La règle @ <strong><code>@page</code></strong> est utilisée afin de modifier certaines propriétés CSS lorsqu'on imprime un document. La règle <code>@page</code> ne permet par de modifier toutes les propriétés mais uniquement celles qui portent sur les marges, les lignes orphelines et veuves ainsi que les sauts de page du document. Si on utilise cette règle @ pour modifier une autre propriété, ce changement sera ignoré.</p> +La règle @ **`@page`** est utilisée afin de modifier certaines propriétés CSS lorsqu'on imprime un document. La règle `@page` ne permet par de modifier toutes les propriétés mais uniquement celles qui portent sur les marges, les lignes orphelines et veuves ainsi que les sauts de page du document. Si on utilise cette règle @ pour modifier une autre propriété, ce changement sera ignoré. -<pre class="brush: css no-line-numbers">@page { +```css +@page { margin: 1cm; } @page :first { margin: 2cm; -}</pre> +} +``` + +La règle @ `@page` peut être manipulée via le CSSOM, notamment avec l'interface {{domxref("CSSPageRule")}}. -<p>La règle @ <code>@page</code> peut être manipulée via le CSSOM, notamment avec l'interface {{domxref("CSSPageRule")}}.</p> +> **Note :** Le W3C est en train de discuter de la gestion des unités de longueur ({{cssxref("<length>")}}) relative à la zone d'affichage (_viewport_) : `vh`, `vw`, `vmin` et `vmax`. En attendant, il est conseillé de ne pas les utiliser au sein d'une règle `@page`. -<div class="note"> - <p><strong>Note :</strong> Le W3C est en train de discuter de la gestion des unités de longueur ({{cssxref("<length>")}}) relative à la zone d'affichage (<em>viewport</em>) : <code>vh</code>, <code>vw</code>, <code>vmin</code> et <code>vmax</code>. En attendant, il est conseillé de ne pas les utiliser au sein d'une règle <code>@page</code>.</p> -</div> +## Syntaxe -<h2 id="Syntaxe">Syntaxe</h2> +### Descripteurs -<h3 id="Descripteurs">Descripteurs</h3> +- [`size`](/fr/docs/Web/CSS/@page/size) + - : Définit la taille et l'orientation du bloc englobant la boîte de la page. En général, lorsqu'une boîte correspondant à une page est rendu sur une feuille, cela indique la taille de la page utilisée. -<dl> - <dt><a href="/fr/docs/Web/CSS/@page/size"><code>size</code></a></dt> - <dd>Définit la taille et l'orientation du bloc englobant la boîte de la page. En général, lorsqu'une boîte correspondant à une page est rendu sur une feuille, cela indique la taille de la page utilisée.</dd> -</dl> +<!----> -<dl> - <dt><code><a href="/fr/docs/orphaned/Web/CSS/@page/marks">marks</a></code></dt> - <dd>Ajoute des marques pour la découpe ou l'alignement des pages du document.</dd> -</dl> +- [`marks`](/fr/docs/orphaned/Web/CSS/@page/marks) + - : Ajoute des marques pour la découpe ou l'alignement des pages du document. -<dl> - <dt><a href="/fr/docs/orphaned/Web/CSS/@page/bleed"><code>bleed</code></a></dt> - <dd>Définit la limite au-delà de la boîte de la page au-delà de laquelle le contenu affiché est rogné.</dd> -</dl> +<!----> -<h3 id="Syntaxe_formelle">Syntaxe formelle</h3> +- [`bleed`](/fr/docs/orphaned/Web/CSS/@page/bleed) + - : Définit la limite au-delà de la boîte de la page au-delà de laquelle le contenu affiché est rogné. + +### Syntaxe formelle {{csssyntax}} -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: css">@page :first { +```css +@page :first { margin: 2cm 3cm; -} </pre> - -<p>Pour d'autres exemples, voir les pages qui concernent les pseudo-classes liées à <code>@page</code> :</p> - -<ul> - <li>{{cssxref(":blank")}}</li> - <li>{{cssxref(":first")}}</li> - <li>{{cssxref(":left")}}</li> - <li>{{cssxref(":right")}}</li> - <li>{{cssxref(":recto")}} {{experimental_inline}}</li> - <li>{{cssxref(":verso")}} {{experimental_inline}}</li> -</ul> - -<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', '#logical-page', ':recto and :verso')}}</td> - <td>{{Spec2('CSS Logical Properties')}}</td> - <td>Ajout des sélecteurs de page <code>:recto</code> et <code>:verso</code>.</td> - </tr> - <tr> - <td>{{SpecName('CSS3 Paged Media', '#at-page-rule', '@page')}}</td> - <td>{{Spec2('CSS3 Paged Media')}}</td> - <td>Aucun changement depuis {{SpecName('CSS2.1')}}, bien que plus de règles @ puissent être utilisées au sein d'une règle <code>@page</code>.</td> - </tr> - <tr> - <td>{{SpecName('CSS2.1', 'page.html#page-selectors', '@page')}}</td> - <td>{{Spec2('CSS2.1')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("css.at-rules.page")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=286443">Le bug de suivi Mozilla pour l'ensemble des fonctionnalités associées aux médias paginés.</a></li> -</ul> +} +``` + +Pour d'autres exemples, voir les pages qui concernent les pseudo-classes liées à `@page` : + +- {{cssxref(":blank")}} +- {{cssxref(":first")}} +- {{cssxref(":left")}} +- {{cssxref(":right")}} +- {{cssxref(":recto")}} {{experimental_inline}} +- {{cssxref(":verso")}} {{experimental_inline}} + +## Spécifications + +| Spécification | État | Commentaires | +| ---------------------------------------------------------------------------------------------------- | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- | +| {{SpecName('CSS Logical Properties', '#logical-page', ':recto and :verso')}} | {{Spec2('CSS Logical Properties')}} | Ajout des sélecteurs de page `:recto` et `:verso`. | +| {{SpecName('CSS3 Paged Media', '#at-page-rule', '@page')}} | {{Spec2('CSS3 Paged Media')}} | Aucun changement depuis {{SpecName('CSS2.1')}}, bien que plus de règles @ puissent être utilisées au sein d'une règle `@page`. | +| {{SpecName('CSS2.1', 'page.html#page-selectors', '@page')}} | {{Spec2('CSS2.1')}} | Définition initiale. | + +## Compatibilité des navigateurs + +{{Compat("css.at-rules.page")}} + +## Voir aussi + +- [Le bug de suivi Mozilla pour l'ensemble des fonctionnalités associées aux médias paginés.](https://bugzilla.mozilla.org/show_bug.cgi?id=286443) |