XSL-FO region-startObjet
Manuel de référence XSL-FO
Définition et utilisation
L'objet <fo:region-start> définit la région gauche de la page (barre latérale gauche).
XSL-FO utilise les éléments suivants pour définir les régions de 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 à l'intérieur de region-body ne chevauche le texte d'autres régions, les marges de region-body doivent être au moins de la même taille que les quatre sous-régions mentionnées ci-dessus.
Remarque :Selon la recommandation XSL-FO 1.0, les propriétés padding et border-width doivent être à 0.
Syntaxe
<!--
Contenu : EMPTY
-->
</fo:region-start>
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 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 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 (haut, bas, gauche, 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 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 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