XSL-FO region-beforeObjet
Manuel de référence XSL-FO
Définition et utilisation
L'objet <fo:region-before> définit la région supérieure (en-tête) d'une page.
XSL-FO utilise les éléments suivants pour définir les régions d'une page :
- <fo:region-body> définit la région du corps
- <fo:region-before> définit la région supérieure (en-tête)
- <fo:region-after> définit la région inférieure (pied de page)
- <fo:region-start> définit la région gauche (barre latérale gauche)
- <fo:region-end> définit la région droite (barre latérale droite)
Remarque :region-before, region-after, region-start et region-end font tous partie de region-body. Pour éviter que le texte de region-body ne chevauche le texte d'autres régions, la marge de region-body doit être au moins égale à la taille des quatre sous-régions mentionnées ci-dessus.
Remarque :Selon la Recommandation XSL-FO 1.0, les attributs padding et border-width doivent être égaux à 0.
Syntaxe
<!--
Contenu : EMPTY
-->
</fo:region-before>
Attributes
| Attributs [A-B] | Attributs [C-Z] |
|---|---|
| background-attachment | clip |
| background-color | display-align |
| background-image | extent |
| background-repeat | overflow |
| background-position-horizontal | padding-after |
| background-position-vertical | padding-before |
| border-after-color | padding-bottom |
| border-after-style | padding-end |
| border-after-width | padding-left |
| border-before-color | padding-right |
| border-before-style | padding-start |
| border-before-width | padding-top |
| border-bottom-color | precedence |
| border-bottom-style | region-name |
| border-bottom-width | reference-orientation |
| border-end-color | writing-mode |
| border-end-style | |
| border-end-width | |
| border-left-color | |
| border-left-style | |
| border-left-width | |
| border-right-color | |
| border-right-style | |
| border-right-width | |
| border-start-color | |
| border-start-style | |
| border-start-width | |
| border-top-color | |
| border-top-style | |
| border-top-width |
Exemple 1
XSL-FO utilise des modèles de page appelés « Page Masters » pour définir la disposition des pages. Chaque modèle doit avoir un nom unique :
<fo:region-body margin="5in" />
</fo:simple-page-master>
<fo:simple-page-master master-name="left">
<fo:region-body margin-left="2in" margin-right="3in" />
</fo:simple-page-master>
<fo:simple-page-master master-name="right">
<fo:region-body margin-left="3in" margin-right="2in" />
</fo:simple-page-master>
Dans l'exemple ci-dessus, trois éléments <fo:simple-page-master> définissent trois modèles différents. Chaque modèle (page-master) a un nom différent.
Le premier modèle est nommé "intro". Il peut être utilisé comme modèle pour la page d'introduction.
Les deuxième et troisième modèles sont nommés « left » et « right ». Ils peuvent être utilisés comme modèles de page pour les numéros de page pairs et impairs.
Exemple 2
Ceci est un fragment extrait d'un document XSL-FO :
page-width="297mm" page-height="210mm"
margin-top="1cm" margin-bottom="1cm"
margin-left="1cm" margin-right="1cm">
<fo:region-body margin="3cm"/>
<fo:region-before extent="2cm"/>
<fo:region-after extent="2cm"/>
<fo:region-start extent="2cm"/>
<fo:region-end extent="2cm"/>
</fo:simple-page-master>
Le code ci-dessus définit un « modèle de page maître simple » nommé « A4 ».
La largeur de la page est de 297 millimètres et la hauteur est de 210 millimètres.
Les quatre marges de la page (marge supérieure, marge inférieure, marge gauche, marge droite) sont toutes de 1 centimètre.
La marge du corps est de 3 centimètres (sur les quatre côtés).
Les régions before, after, start et end du corps mesurent toutes 2 centimètres.
La largeur du corps dans l'exemple ci-dessus peut être calculée en soustrayant les marges gauche et droite et les marges de region-body de la largeur de la page :
297mm - (2 x 1cm) - (2 x 3cm) = 297mm - 20mm - 60mm = 217mm
Notez que les régions (region-start et region-end) ne sont pas incluses dans le calcul. Comme expliqué précédemment, ces régions font partie du corps.
Manuel de référence XSL-FO Autres extensions