size
====

**Expérimental:** **Cette fonction est expérimentale**  
Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.  
Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.

Le descripteur **`size`**, associé à la règle @ `@page`, permet de définir les dimensions et l'orientation de la boîte utilisée pour représenter une page. La plupart du temps, cette taille correspondra à la totalité de la taille de la page imprimée.

Les dimensions de cette boîte peuvent être définies de façon absolues ou relatives (dans ce cas, la page occupera l'espace disponible).

Syntaxe
-------


```css
/\* Des mots-clés qui peuvent être utilisées
 pour remplir l'espace disponible \*/
size: auto;
size: portrait;
size: landscape;

/\* Des valeurs de longueur \*/
/\* Type <length> \*/
/\* 1 valeur : hauteur = largeur \*/
size: 6in;

/\* 2 valeurs : la largeur puis la hauteur \*/
size: 4in 6in;

/\* Des mots-clés qui représentent des \*/
/\* dimensions absolues \*/
size: A4;
size: B5;
size: JIS-B4;
size: letter;

/\* Une déclaration incluant la taille et l'orientation \*/
size: A4 portrait;
```

### Valeurs

`auto`

L'agent utilisateur décidera de la taille de page. En général, ce seront les dimensions de la page cible (celle sur laquelle imprimer/afficher) qui seront utilisées.

`landscape`

Le contenu de la page est affiché en paysage (le côté le plus long de la page sera le côté horizontal).

`portrait`

Le contenu de la page est affiché en portrait (le côté le plus long de la page sera le côté vertical).

`<length>`

Une valeur de longueur (cf. `<length>`). La première valeur utilisée correspond à la largeur de la boîte de la page et la deuxième correspond à la hauteur. Si une seule valeur est fournie, celle-ci sera utilisée pour la largeur et pour la hauteur.

`<page-size>`

Un mot-clé avec l'une des valeurs suivantes :

`A5`

Ce mot-clé correspond aux dimensions ISO standard : 148mm x 210mm.

`A4`

Ce mot-clé correspond aux dimensions ISO standard : 210mm x 297mm (c'est le format le plus utilisé pour les impressions occasionnelles sur les imprimantes personnelles).

`A3`

Ce mot-clé correspond aux dimensions ISO standard : 297mm x 420mm.

`B5`

Ce mot-clé correspond aux dimensions ISO standard : 176mm x 250mm.

`B4`

Ce mot-clé correspond aux dimensions ISO standard : 250mm x 353mm.

`JIS-B5`

Ce mot-clé correspond aux dimensions JIS standard : 182mm x 257mm.

`JIS-B4`

Ce mot-clé correspond aux dimensions JIS standard : 257mm x 364mm.

`letter`

Ce mot-clé correspond à la taille standard du papier à lettre aux États-Unis : 8.5in x 11in.

`legal`

Ce mot-clé correspond à la taille standard des documents légaux aux États-Unis : 8.5in par 14in.

`ledger`

Ce mot-clé correspond à la taille standard des pages d'un livre en grand format aux États-Unis. Cela correspond à : 11in x 17in.


Définition formelle
-------------------

|  |  |
| --- | --- |
| En lien avec les règles @ | `@page` |
| Valeur initiale | `auto` |
| Valeur calculée | comme spécifié, mais avec les longueurs relatives converties en longueurs absolues |

Syntaxe formelle
----------------
```

size =   
  <length [0,∞]>{1,2}                          |  
  auto                                         |  
  [ <page-size> || [ portrait | landscape ] ]    
  
```

Exemples
--------


```css
@page {
  size: 4cm 6cm landscape;
}
```



```css
@media print {
  @page {
    size: 50mm 150mm;
  }
}
```

Spécifications
--------------

| Specification |
| --- |
| CSS Paged Media Module Level 3 # page-size-prop |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* `bleed`
* `marks`