XSL-FO region-bodyObjet
Manuel de référence XSL-FO
Définition et utilisation
L'objet <fo:region-body> définit la région principale 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 principale
- <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 dans region-body ne chevauche le texte d'autres régions, la marge de region-body doit être au moins de la même taille que les dimensions des quatre sous-régions mentionnées ci-dessus.
Astuce :Pour fournir plusieurs colonnes dans la zone region-body, l'attribut column-count doit être défini à une valeur supérieure à 1!/p>
Remarque :Si la valeur de l'attribut overflow est "scroll", vous ne pouvez pas définir l'attribut column-count à une valeur supérieure à 1 !
Remarque :Selon la Recommandation XSL-FO 1.0, les attributs padding et border-width doivent être égaux à 0.
Syntaxe
<!--
Contenu : EMPTY
-->
</fo:region-body>
Attributes
| Attributs [A-B] | Attributs [C-Z] |
|---|---|
| background-attachment | clip |
| background-color | column-count |
| background-image | column-gap |
| background-repeat | display-align |
| background-position-horizontal | end-indent |
| background-position-vertical | margin-bottom |
| border-after-color | margin |
| border-after-style | margin-right |
| border-after-width | margin-top |
| border-before-color | overflow |
| border-before-style | padding-after |
| border-before-width | padding-before |
| border-bottom-color | padding-bottom |
| border-bottom-style | padding-end |
| border-bottom-width | padding-left |
| border-end-color | padding-right |
| border-end-style | padding-start |
| border-end-width | padding-top |
| border-left-color | region-name |
| border-left-style | reference-orientation |
| border-left-width | space-after |
| border-right-color | space-before |
| border-right-style | writing-mode |
| 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 mise en page. 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 pages paires et impaires.
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.
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 sont toutes de 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