XSL-FO region-endObjet
Manuel de référence XSL-FO
Définition et utilisation
L'objet <fo:region-end> définit la région droite de la page (barre latérale droite).
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. Afin d'éviter que le texte dans region-body ne recouvre le texte des autres régions, les marges de region-body doivent être au moins aussi grandes que les dimensions des quatre sous-régions ci-dessus.
Remarque :Selon la recommandation de la version XSL-FO 1.0, les attributs padding et border-width doivent être 0.
Syntaxe
<!--
Contenu : EMPTY
-->
</fo:region-end>
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 | region-name |
| border-bottom-style | reference-orientation |
| border-bottom-width | writing-mode |
| border-end-color | |
| 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 nommés "Page Masters" pour définir la mise en page 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 page (marge supérieure, marge inférieure, marge gauche, marge droite) sont toutes de 1 centimeter.
Les marges du corps sont de 3 centimètres (sur les quatre côtés).
Les régions before, after, start et end du corps font 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
Veuillez noter 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