XSL-FO region-startObjekt

Definition und Verwendung

Das Objekt <fo:region-start> definiert den linken Bereich der Seite (linke Seitenleiste).

XSL-FO verwendet die folgenden Elemente, um Seitenbereiche 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 verhindern, dass Text innerhalb von region-body Text in anderen Regionen überlappt, müssen die Ränder von region-body mindestens so groß sein wie die vier oben genannten Unterregionen.

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

Syntax

<fo:region-start>

</fo:region-start>

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 Seitenlayout 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 Millimeter und die Höhe 210 Millimeter.

Die vier Seitenränder (oben, unten, links, rechts) sind alle 1 Zentimeter.

Der Rand des Body beträgt 3 Zentimeter (auf allen vier Seiten).

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

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

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

Beachten Sie, dass die Regionen (region-start und region-end) nicht in die Berechnung einbezogen werden. Wie bereits erläutert, sind diese Regionen Teil des Hauptbereichs.

XSL-FO Referenzhandbuch Weitere Erweiterungen

XSLFOReferenzhandbuch