size

Baseline 2024

Newly available

Since December 2024, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

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.

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 initialeauto
Valeur calculéecomme 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

Voir aussi