Size - Propriété CSS

size

Résumé des caractéristiques de la propriété `size`

Description rapide

Dimensions et orientation des pages imprimées.

Statut

Standard

Utilisable sur

HTML

Valeurs prédéfinies

Pourcentages

Ne s'appliquent pas.

Valeur initiale

auto

Héritée par défaut

Non.

Type d'animation

Not animable : la propriété size ne peut pas être animée.

Module W3C

Module CSS - Media paginé

Références (W3C)

CSS Paged Media Module Level 3

Statut du document: WD (document de travail)

Schéma syntaxique de `size`.

Schéma syntaxique de la propriété size
Les liens du schéma donnent accès à plus de détails
Télécharger le schéma en SVG

Description des termes utilisés sur le schéma :

length sont des valeurs numériques suivies d'une des unités de dimension, et correspondant à la largeur et la hauteur de la page.
format est un format de papier standard : a4, letter, legal.

Description de la propriété `size`.

size définit les dimensions et l'orientation des pages imprimées. Cette propriété ne s'applique qu'au sélecteur @page.

Si deux dimensions sont indiquées, elles correspondent respectivement à la largeur et à la hauteur de la page. Si une seule dimension est indiquée, elle s'applique aussi bien à la largeur qu'à la hauteur (autrement dit, la page sera carrée).

Il est possible également d'indiquer un format de papier standard, a4, letter, legal, etc. suivi de l'orientation : landscape ou portrait.

Attention ! Les dimensions physiques des feuilles de papier peuvent être différentes de celles qui sont précisées pour la page. Dans ce cas, les navigateurs peuvent être amenés à :

Tourner la page de 90°.
Appliquer un facteur de réduction pour faire tenir la page dans la feuille.
Augmenter les marges ou centrer la page si elle est plus petite que la feuille.

Valeurs pour `size`.

size: auto;

Valeur par défaut. L'utilisateur choisit la taille des pages au moment de l'impression.
size: a3; size: a4; size: a5; size: b4; size: b5;

La taille de la page imprimée est fixée à l'un des formats ISO suivants :
1. A3 : 29,7 cm x 42cm.
2. A4 : 21 cm x 29,7cm.
3. A5 : 14,8 cm x 21cm.
4. B4 : 25 cm x 35,3 cm.
5. B5 : 17,6 cm x 25 cm.
size: JIS-B4; size: JIS-B5;

La taille de la page imprimée est fixée à l'un des formats suivants :
1. JIS-B4 : 25,7 cm x 36,4 cm.
2. JIS-B5 : 18,2 cm x 25,7 cm.
size: letter; size: legal; size: ledger;

Formats nord-américain :
1. letter : 8,5 pouces x 11 pouces (21,59 cm x 27,94 cm).
2. legal : 8,5 pouces x 14 pouces (21,59 cm x 35,56 cm).
3. ledger : 11 pouces x 17 pouces (27,94 cm x 43,18 cm).
size: 20cm 30cm; l h

Les dimensions de la page sont définies par ces deux valeurs (l est la largeur, h est la hauteur). Il est donc possible de spécifier des formats non standards ou appartenant à un standard différent.

Ce sont deux valeurs positives suivies d'une des unités de dimension.
size: a4 portrait; size: b5 landscape;

Les valeurs portrait et landscape peuvent compléter l'indication d'un format standard.
1. portrait : le côté le plus grand est vertical.
2. landscape : le côté le plus grand est horizontal.

Valeurs standards :


size: initial  (auto)
size: inherit
size: revert
size: revertLayer
size: unset

Pour plus d'informations, reportez-vous aux pages de présentation de ces différentes valeurs : initial, inherit, revert, revert-layer, unset.

Animation de la propriété `size`.

Comme toutes les propriétés relatives à l'impression, ou celles qui s'appliquent au sélecteur @page, size ne peut pas être animée.

Manipulation de la propriété `size` par programme.

Avec Javascript, modifier la valeur de `size`.

La propriété size présente la particularité de n'être applicable que sur le sélecteur @page. Or ce dernier n'est pas un élément du DOM, et n'est donc pas accessible directement via Javascript. Voici cependant un exemple de code qui permet de modifier la valeur de size. Il consiste à créer un élément style dans la section head de la page. N'importe quelle règle CSS peut ensuite être insérée dans cet élément.


	const style = document.createElement('style');
	style.innerHTML = '@page {size: a4 portrait;}';
	document.head.appendChild(style);

Prise en charge par les navigateurs (compatibilité).

La propriété size n'est pas reconnue par les navigateurs.

Historique de la propriété `size`.

Module CSS - Media paginé - Niveau 3

Première présentation de la propriété size.

23 Juin 1999
Document de travail.
25 Février 2004
Candidat à la recommandation.

Voir aussi, au sujet des impressions.

Tout ce qui concerne les impressions via un module paginé (page par page) est décrit dans le module CSS Paged Media Module. La propriété size fait partie du module, ainsi que les définitions suivantes :