XSL-FO region-endObjekt

Definition und Verwendung

Das <fo:region-end>-Objekt definiert den rechten Bereich der Seite (rechte Seitenleiste).

XSL-FO verwendet die folgenden Elemente, um die Bereiche einer Seite zu definieren:

<fo:region-body> definiert den Hauptbereich
<fo:region-before> definiert die obere Region (Kopfzeile)
<fo:region-after> definiert den unteren Bereich (Fußzeile)
<fo:region-start> definiert den linken Bereich (linke Seitenleiste)
<fo:region-end> definiert den rechten Bereich (rechte Seitenleiste)

Hinweis:region-before, region-after, region-start und region-end sind alle Teil von region-body. Um zu vermeiden, dass Text innerhalb von region-body den Text anderer Regionen überdeckt, müssen die Ränder von region-body mindestens so groß sein wie die Abmessungen der oben genannten vier Unterregionen.

Hinweis:Gemäß der Empfehlung für die Version XSL-FO 1.0 müssen die Attribute padding und border-width 0 sein.

Syntax

<fo:region-end>

</fo:region-end>

Attribute

Attribute [A-B]	Attribute [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

Beispiel 1

XSL-FO verwendet Seitenvorlagen namens "Page Masters", um das Layout von Seiten zu definieren. Jede Vorlage muss einen eindeutigen Namen haben:

<fo:simple-page-master master-name="intro">
<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>

Im obigen Beispiel definieren drei <fo:simple-page-master>-Elemente drei verschiedene Vorlagen. Jede Vorlage (page-master) hat einen anderen Namen.

Die erste Vorlage heißt "intro". Sie kann als Vorlage für die Einführungsseite verwendet werden.

Die zweite und dritte Vorlage heißen „left“ und „right“. Sie können als Seitenvorlagen für gerade und ungerade Seitenzahlen verwendet werden.

Beispiel 2

Dies ist ein Fragment, das aus einem XSL-FO-Dokument extrahiert wurde:

<fo:simple-page-master master-name="A4"
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>

Der obige Code definiert ein "Simple Page Master Template" namens "A4".

Die Seitenbreite beträgt 297 millimeters und die Höhe 210 millimeters.

Die vier Seitenränder (oberer Rand, unterer Rand, linker Rand, rechter Rand) sind alle 1 Zentimeter.

Die Ränder des Body sind 3 centimeters (auf allen vier Seiten).

Die Regionen before, after, start und end des Body sind alle 2 centimeters.

Die Breite des Body im obigen Beispiel kann berechnet werden, indem die linken und rechten Ränder und die Ränder von region-body von der Seitenbreite abgezogen werden:

297mm - (2 x 1cm) - (2 x 3cm) = 297mm - 20mm - 60mm = 217mm

Bitte beachten Sie, dass die Regionen (region-start und region-end) nicht in die Berechnung einbezogen werden. Wie zuvor erläutert, sind diese Regionen Teil des Textkörpers.

XSL-FO Referenzhandbuch Weitere Erweiterungen

XSLFOReferenzhandbuch