fo:list-block

(Auszug aus "XSL-FO ― Die Referenz" von Manuel Montero Pineda & Steffen Herkert, 2016, dpunkt.verlag)

A | B | C | D | E | F | G | H | I | J | K | L | M | N | O | P | Q | R | S | T | U | V | W | X | Y | Z

Recommendationnummer: 6.8.2

Kategorie: 6.8 Formatting Objects for Lists

Beschreibung

Dieses Element erzeugt einen Bereich zur Darstellung einer Liste bzw. Aufzählung.

XSL-FO Version: 1.0

Elternelemente

<fo:basic-link> , <fo:bidi-override> , <fo:block> , <fo:block-container> , <fo:float> , <fo:flow> , <fo:footnote-body> , <fo:inline> , <fo:inline-container> , <fo:list-item-body> , <fo:list-item-label> , <fo:marker> , <fo:multi-case> , <fo:multi-toggle> , <fo:static-content> , <fo:table-caption> , <fo:table-cell> und <fo:wrapper>

Kindelemente

<fo:list-item> Dieses Element enthält sowohl die Angaben über die Beschriftung als auch den Rumpf eines Listenelements.

Attribute

background Mit diesem Attribut lassen sich mehrere Eigenschaften für den Hintergrund gleichzeitig festlegen. So können eine Farbe (background-color), eine Hintergrundgrafik (background-image), die Wiederholungsrate (background-repeat) eines Hintergrunds wenn eine angegebene Grafik nicht den kompletten für sie reservierten Bereich ausfüllt (Kachelung), das Verhalten beim Scrollen (background-attachment) und die Positionierung (background-position) zusammen in einer Eigenschaft angegeben werden. Dabei ist die Anzahl und das Vorkommen der einzelnen Eigenschaften frei kombinierbar. Die Angaben müssen mit einer Leerstelle voneinander abgetrennt werden. Werden nicht für alle Eigenschaften Werte festgelegt, so werden für diese die voreingestellten Werte der entsprechenden Einzeleigenschaften übernommen.
background-attachment Dieses Attribut legt fest, inwieweit ein Hintergrund mitläuft, wenn der Vordergrund ge­scrollt wird.
background-color Mit diesem Attribut lässt sich für den Hintergrund eine Farbe angeben.
background-image Dieses Attribut erzeugt mithilfe einer Pfadangabe uri-specification ein Hintergrundbild im Element.
background-position Diese Eigenschaft wird verwendet, um sowohl die horizontale als auch die vertikale Positionierung eines Hintergrundbildes, das mit background-image angegeben worden ist, gleichzeitig festzulegen. Nach der Voreinstellung wird die Hintergrundgrafik im Element, in dem der Aufruf erfolgt, bündig an der oberen linken Ecke ausgerichtet. Mit dieser Eigenschaft kann die Positionierung mittels Prozentangabe percentage und/oder absoluter Maßangabe length oder Konstanten bestimmt werden. Hierbei können wahlweise entweder ein Wert oder zwei Werte, die dann durch Leerstelle voneinander getrennt werden müssen, angegeben werden. Werden zwei Werte angegeben, so bezieht sich der erste Wert immer auf die horizontale und der zweite Wert auf die vertikale Positionierung. Wird nur ein Wert angegeben, so gilt dieser für die horizontale Positionierung. Für die vertikale Position wird dann standardmäßig ein Wert von 50% angenommen.<fo:block-container background-image="hintergrund.eps" background-position="75%>Es ist sogar zulässig, einen Wert mit einer absoluten Maßzahl festzulegen, den anderen jedoch mit einer Prozentangabe percentage. <fo:block-container background-image="hintergrund.eps" background-position="75mm 10%> Auch wenn die Werte mit Konstanten festgelegt werden, können wahlweise ein oder zwei Werte angelegt werden.<fo:block-container background-image="hintergrund.eps" background-position="top right"> Wird nur ein Wert angegeben, so gilt dieser für die Achse, für die der Wert definiert ist. Der Wert für die andere Achse wird auf center gesetzt. <fo:block-container background-image="hintergrund.eps" background-position="top">
background-position-horizontal Mit dieser Eigenschaft kann die horizontale Positionierung eines mit dieser Eigenschaft ausgezeichneten Bereichs wahlweise mittels einer Prozentangabe percentage, einer absoluten Maßangabe length oder einem vorgegebenen Wert (left, center, right) angegeben werden.
background-position-vertical Mit dieser Eigenschaft kann die vertikale Positionierung eines mit dieser Eigenschaft ausgezeichneten Bereichs wahlweise mittels einer Prozentangabe percentage oder einer absoluten Maßangabe length angegeben werden.
background-repeat Diese Eigenschaft wird verwendet, um für einen Bereich, der eine Hintergrundabbildung (background-image) enthält, das Verhalten zur wiederholten Darstellung dieser Abbildung festzulegen (Kachelung). Durch die Voreinstellung ist eine generelle Wiederholung eines Hintergrundmotivs vorgesehen.
border Dieses Attribut wird verwendet, um für alle Rahmenseiten (oben, links, unten, rechts) eines Bereichs gleichzeitig Werte für die Eigenschaften Breite (border-width), Farbe (border-color) und Stil (border-style) festzulegen. Dabei können wahlweise nur für eine, zwei oder alle drei Eigenschaften Werte angegeben werden. Wenn zwei oder drei Werte angegeben werden, müssen diese durch eine Leerstelle voneinander getrennt werden.
border-after-color Dieses Attribut wird zum Anlegen der Farbe für einen unteren Rahmenteil verwendet. Der after-Bereich richtet sich nach der vorherrschenden Schreibrichtung. Bezogen auf die westliche Schreibrichtung (oben nach unten, links nach rechts) ist dieser unten. Falls eine andere Schreibrichtung vorliegt, könnte dies auch oben sein.
border-after-style Dieses Attribut wird zum Anlegen des Stils für einen unteren Rahmenteil verwendet. Der after-Bereich richtet sich nach der vorherrschenden Schreibrichtung. Bezogen auf die westliche Schreibrichtung (oben nach unten, links nach rechts) ist dieser unten. Falls eine andere Schreibrichtung vorliegt, könnte dies auch oben sein.
border-after-width Dieses Attribut wird zum Anlegen der Breite für einen unteren Rahmenteil verwendet. Der after-Bereich richtet sich nach der vorherrschenden Schreibrichtung. Bezogen auf die westliche Schreibrichtung (oben nach unten, links nach rechts) ist dieser unten. Falls eine andere Schreibrichtung vorliegt, könnte dies auch oben sein.
border-before-color Dieses Attribut wird zum Anlegen der Farbe für einen oberen Rahmenteil verwendet. Der before-Bereich richtet sich nach der vorherrschenden Schreibrichtung. Bezogen auf die westliche Schreibrichtung (oben nach unten, links nach rechts) ist dieser oben. Falls eine andere Schreibrichtung vorliegt, könnte dies auch unten sein.
border-before-style Dieses Attribut wird zum Anlegen des Stils für einen oberen Rahmenteil verwendet. Der before-Bereich richtet sich nach der vorherrschenden Schreibrichtung. Bezogen auf die westliche Schreibrichtung (oben nach unten, links nach rechts) ist dieser oben. Falls eine andere Schreibrichtung vorliegt, könnte dies auch unten sein.
border-before-width Dieses Attribut wird zum Anlegen der Breite für einen oberen Rahmenteil verwendet. Der before-Bereich richtet sich nach der vorherrschenden Schreibrichtung. Bezogen auf die westliche Schreibrichtung (oben nach unten, links nach rechts) ist dieser oben. Falls eine andere Schreibrichtung vorliegt, könnte dies auch unten sein.
border-bottom Dieses Attribut wird verwendet, um für den unteren Rahmenteil eines Bereichs gleichzeitig Werte für die Eigenschaften Breite (border-bottom-width), Farbe (border-bottom-color) und Stil (border-bottom-style) festzulegen. Dabei können wahlweise nur für eine, zwei oder alle drei Eigenschaften Werte angegeben werden. Wenn zwei oder drei Werte angegeben werden, müssen diese durch eine Leerstelle voneinander getrennt werden.
border-bottom-color Dieses Attribut wird zum Anlegen der Farbe für einen unteren Rahmenteil verwendet.
border-bottom-style Dieses Attribut wird zum Anlegen des Stils für einen unteren Rahmenteil verwendet.
border-bottom-width Dieses Attribut wird zum Anlegen der Breite für einen unteren Rahmenteil verwendet.
border-color Dieses Attribut wird verwendet, um für alle Rahmenseiten (oben, links, unten, rechts) eines Bereichs einen einheitlichen Wert für die Farbe festzulegen.
border-end-color Dieses Attribut wird zum Anlegen der Farbe für einen rechten Rahmenteil verwendet. Der end-Bereich richtet sich nach der vorherrschenden Schreibrichtung. Bezogen auf die westliche Schreibrichtung (oben nach unten, links nach rechts) ist dieser rechts. Falls eine andere Schreibrichtung (z. B. Arabisch) vorliegt, kann dieser auch links sein.
border-end-style Dieses Attribut wird zum Anlegen des Stils für einen rechten Rahmenteil verwendet. Der end-Bereich richtet sich nach der vorherrschenden Schreibrichtung. Bezogen auf die westliche Schreibrichtung (oben nach unten, links nach rechts) ist dieser rechts. Falls eine andere Schreibrichtung vorliegt, könnte dies auch links sein.
border-end-width Dieses Attribut wird zum Anlegen der Breite für einen rechten Rahmenteil verwendet. Der end-Bereich richtet sich nach der vorherrschenden Schreibrichtung. Bezogen auf die westliche Schreibrichtung (oben nach unten, links nach rechts) ist dieser rechts. Falls eine andere Schreibrichtung vorliegt, könnte dies auch links sein.
border-left Dieses Attribut wird verwendet, um für den linken Rahmenteil eines Bereichs gleichzeitig Werte für die Eigenschaften Breite (border-left-width), Farbe (border-left-color) und Stil (border-left-style) festzulegen. Dabei können wahlweise nur für eine, zwei oder alle drei Eigenschaften Werte angegeben werden. Wenn zwei oder drei Werte angegeben werden, müssen diese durch eine Leerstelle voneinander getrennt werden.
border-left-color Dieses Attribut wird zum Anlegen der Farbe für einen linken Rahmenteil verwendet.
border-left-style Dieses Attribut wird zum Anlegen des Stils für einen linken Rahmenteil verwendet.
border-left-width Dieses Attribut wird zum Anlegen der Breite für einen linken Rahmenteil verwendet.
border-right Dieses Attribut wird verwendet, um für den rechten Rahmenteil eines Bereichs gleichzeitig Werte für die Eigenschaften Breite (border-right-width), Farbe (border-right-color) und Stil (border-right-style) festzulegen. Dabei können wahlweise nur für eine, zwei oder alle drei Eigenschaften Werte angegeben werden. Wenn zwei oder drei Werte angegeben werden, müssen diese durch eine Leerstelle voneinander getrennt werden.
border-right-color Dieses Attribut wird zum Anlegen der Farbe für einen rechten Rahmenteil verwendet.
border-right-style Dieses Attribut wird zum Anlegen des Stils für einen rechten Rahmenteil verwendet.
border-right-width Dieses Attribut wird zum Anlegen der Breite für einen rechten Rahmenteil verwendet.
border-spacing Dieses Attribut wird zum Anlegen eines Abstandes zwischen benachbarten Zellen einer Tabelle (fo:table) verwendet. Dafür muss auch die Eigenschaft border-collapse auf den Wert separate gesetzt werden. Der anzunehmende Wert gilt sowohl für die Breite als auch für die Höhe. Unter Verwendung der entsprechenden Komponenten für Höhe (block-progression-direction) und Breite (inline-progression-direction) lassen sich diese auch getrennt angeben.
border-start-color Dieses Attribut wird zum Anlegen der Farbe für einen linken Rahmenteil verwendet. Der start-Bereich richtet sich nach der vorherrschenden Schreibrichtung. Bezogen auf die westliche Schreibrichtung (oben nach unten, links nach rechts) ist dieser links. Falls eine andere Schreibrichtung (z. B. Arabisch) vorliegt, kann dieser auch rechts sein.
border-start-style Dieses Attribut wird zum Anlegen des Stils für einen linken Rahmenteil verwendet. Der start-Bereich richtet sich nach der vorherrschenden Schreibrichtung. Bezogen auf die westliche Schreibrichtung (oben nach unten, links nach rechts) ist dieser links. Falls eine andere Schreibrichtung vorliegt, könnte dieser auch rechts sein.
border-start-width Dieses Attribut wird zum Anlegen der Breite für einen linken Rahmenteil verwendet. Der start-Bereich richtet sich nach der vorherrschenden Schreibrichtung. Bezogen auf die westliche Schreibrichtung (oben nach unten, links nach rechts) ist dieser links. Falls eine andere Schreibrichtung vorliegt, kann dieser auch rechts sein.
border-style Dieses Attribut wird verwendet, um für alle Rahmenseiten (oben, links, unten, rechts) eines Bereichs einen einheitlichen Wert für den Stil festzulegen.
border-top Dieses Attribut wird verwendet, um für den oberen Rahmenteil eines Bereichs gleichzeitig Werte für die Eigenschaften Breite (border-top-width), Farbe (border-top-color) und Stil (border-top-style) festzulegen. Dabei können wahlweise nur für eine, zwei oder alle drei Eigenschaften Werte angegeben werden. Wenn zwei oder drei Werte angegeben werden, müssen diese durch eine Leerstelle voneinander getrennt werden.
border-top-color Dieses Attribut wird zum Anlegen der Farbe für einen oberen Rahmenteil verwendet.
border-top-style Dieses Attribut wird zum Anlegen des Stils für einen oberen Rahmenteil verwendet.
border-top-width Dieses Attribut wird zum Anlegen der Breite für einen oberen Rahmenteil verwendet.
border-width Dieses Attribut wird verwendet, um für alle Rahmenseiten (oben, links, unten, rechts) eines Bereichs einen einheitlichen Wert für die Breite festzulegen.
bottom Mit diesem Attribut wird der Abstand festgelegt, den ein positioniertes Objekt (fo:block-container) gemessen vom unteren Rand seines unmittelbar übergeordneten Blockbereichs einnehmen soll.
break-after Mit diesem Attribut wird festgelegt, inwieweit nach einem Bereich, in dem dieses Attribut angelegt worden ist, in eine neue Spalte oder auf eine neue Seite umbrochen werden soll.
break-before Mit diesem Attribut wird festgelegt, inwieweit der Block, in dem dieses Attribut angelegt worden ist, stets in einer neuen Spalte oder auf einer neuen (linken/rechten) Seite beginnen soll.
clear Mit diesem Attribut lässt sich für ein Objekt, das umflossen werden kann (fo:float) (typischerweise eine Abbildung), festlegen, ob dieses links/rechts/beidseitig von sich ein weiteres Element duldet, das ebenfalls umflossen werden kann, oder ob es immer erst dort im Textfluss positioniert werden soll, wo bereits ein anderes zu umfließendes Objekt beendet ist.
end-indent Dieses Attribut legt für einen Bereich eine rechtsbündige Einrückung fest. Der end-Bereich orientiert sich an der vorherrschenden Schreibrichtung. Bezogen auf die westliche Schreibrichtung (oben nach unten, links nach rechts) ist dies rechts. Falls eine andere Schreibrichtung (z. B. Arabisch) vorliegt, kann dies auch links sein.
id Dieses Attribut dient der eindeutigen Kennzeichnung eines Objekts, auf das dann von anderen Objekten aus verwiesen werden kann.
index-class Mit diesem Attribut lässt sich eine Indexklasse für einzelne Indexeinträge (index-key) oder für einen ganzen Bereich definieren. Alle Indexeinträge in dem entsprechenden Bereich gehören dann dieser Indexklasse an. Wird nun auf Indexeinträge referenziert (fo:index-key-reference), die verschiedenen Klassen angehören, werden die entsprechenden Seitenzahlen getrennt voneinander aufgeführt, selbst wenn sie auf aufeinanderfolgenden Seiten stehen. Beispielsweise wird "1-8" durch "1-4,5-8" ersetzt, wenn die Einträge auf den Seiten 1-4 alle derselben Klasse angehören und die Seiten 5-8 einer anderen Klasse. Dies kann zur Anwendung kommen, wenn Seiten in unterschiedliche Bereiche mit unterschiedlichen Nummerierungen gegliedert werden. Eine Nummerierung wie "I-14" kann so vermieden und durch "I-V,1-14" ersetzt werden.
index-key Mit diesem Attribut lässt sich ein Indexeintrag definieren. Der übergebene Wert wird als Bezeichner des Indexeintrags verwendet. Über eine Referenz eines Indexeintrags (fo:index-key-reference) kann auf alle Einträge mit diesem Bezeichner referenziert und deren Seitenzahlen können so einer Liste von Seitenzahlreferenzen (fo:index-page-citation-list) hinzugefügt werden.
intrusion-displace Dieses Attribut bestimmt, wie ein Bereich mit Inhalten gefüllt wird, wenn mit dem Element fo:float innerhalb des Bereichs ein Objekt eingebunden wird. Es kann den gesamten Bereich ausfüllen, der nicht vom Objekt eingenommen wird, oder oberhalb und unterhalb des eingebundenen Objekts Weißraum frei lassen, sodass eine Spalte entsteht. Auf diese Weise können Marginalienspalten realisiert werden.
keep-together Mit diesem Attribut kann angegeben werden, dass innerhalb des ausgezeichneten Bereichs kein Zeilen-, Spalten- oder Seitenumbruch vorkommen darf. Dies kann mit den Komponentenattributen keep-together.within-line (für Zeilenumbrüche), keep-together.within-column (für Spaltenumbrüche) und keep-together.within-page (für Seitenumbrüche) konkretisiert werden. Die Angabe im Attribut keep-together allein entspricht der Angabe aller drei Komponentenattributen mit dem gleichen Wert. Wird das Attribut keep-together in Kombination mit einem Komponentenattribut angegeben, gilt es für die jeweils anderen beiden Komponenten. Dem Attribut kann auch eine Priorität mitgegeben werden, falls die Angabe mit einer gegenteiligen Aussage (z. B. innerhalb des Bereichs eine page-break-after-Angabe) kollidieren sollte.
keep-together.within-column Mit diesem Attribut kann angegeben werden, dass innerhalb des ausgezeichneten Bereichs kein Spaltenumbruch vorkommen darf. Dieses spezielle Attribut überschreibt die Angabe, die im allgemeinen Attribut keep-together gemacht wurde. Dem Attribut kann auch eine Priorität mitgegeben werden, falls die Angabe mit einer gegenteiligen Aussage (z. B. innerhalb des Bereichs eine page-break-after-Angabe) kollidieren sollte.
keep-together.within-line Mit diesem Attribut kann angegeben werden, dass innerhalb des ausgezeichneten Bereichs kein Zeilenumbruch vorkommen darf. Dieses spezielle Attribut überschreibt die Einstellungen, die im allgemeinen Attribut keep-together vorgenommen wurden. Dem Attribut kann auch eine Priorität mitgegeben werden, falls die Angabe mit einer gegenteiligen Aussage (z. B. innerhalb des Bereichs eine page-break-after-Angabe) kollidieren sollte.
keep-together.within-page Mit diesem Attribut kann angegeben werden, dass innerhalb des ausgezeichneten Bereichs kein Seitenumbruch vorkommen darf. Dieses spezielle Attribut überschreibt die Einstellungen, die im allgemeinen Attribut keep-together vorgenommen wurden. Dem Attribut kann auch eine Priorität mitgegeben werden, falls die Angabe mit einer gegenteiligen Aussage (z. B. innerhalb des Bereichs eine page-break-after-Angabe) kollidieren sollte.
keep-with-next Mit diesem Attribut kann angegeben werden, dass zwischen dem ausgezeichneten Bereich und dem darauffolgenden Bereich kein Zeilen-, Spalten- oder Seitenumbruch vorkommen darf. Dies kann mit den Komponentenattributen keep-with-next.within-line (für Zeilenumbrüche), keep-with-next.within-column (für Spaltenumbrüche) und keep-with-next.within-page (für Seitenumbrüche) konkretisiert werden. Die Angabe im Attribut keep-with-next allein entspricht der Angabe aller drei Komponentenattribute mit dem gleichen Wert. Wird das Attribut keep-with-next in Kombination mit einem Komponentenattribut angegeben, gilt es für die jeweils anderen beiden Komponenten. Dem Attribut kann auch eine Priorität mitgegeben werden, falls die Angabe mit einer gegenteiligen Aussage (z. B. innerhalb des Bereichs eine page-break-after-Angabe) kollidieren sollte.
keep-with-next.within-column Mit diesem Attribut kann angegeben werden, dass zwischen dem ausgezeichneten Bereich und dem darauffolgenden Bereich kein Spaltenumbruch vorkommen darf. Dieses spezielle Attribut überschreibt die Angabe, die im allgemeinen Attribut keep-with-next gemacht wurde. Dem Attribut kann auch eine Priorität mitgegeben werden, falls die Angabe mit einer gegenteiligen Aussage (z.B. innerhalb des Bereichs eine page-break-after-Angabe) kollidieren sollte. Diese Funktion tritt nur in Kraft, wenn der nachfolgende Bereich auf der Following-Sibling-Achse (im FO-Dokument) definiert wird.
keep-with-next.within-line Mit diesem Attribut kann angegeben werden, dass zwischen dem ausgezeichneten Bereich und dem darauffolgenden Bereich kein Zeilenumbruch vorkommen darf. Dieses spezielle Attribut überschreibt die Angabe, die im allgemeinen Attribut keep-with-next gemacht wurde. Dem Attribut kann auch eine Priorität mitgegeben werden, falls die Angabe mit einer gegenteiligen Aussage (z.B. innerhalb des Bereichs eine page-break-after-Angabe) kollidieren sollte. Diese Funktion tritt nur in Kraft, wenn der nachfolgende Bereich auf der Following-Sibling-Achse (im FO-Dokument) definiert wird.
keep-with-next.within-page Mit diesem Attribut kann angegeben werden, dass zwischen dem ausgezeichneten Bereich und dem darauffolgenden Bereich kein Seitenumbruch vorkommen darf. Dieses spezielle Attribut überschreibt die Angabe, die im allgemeinen Attribut keep-with-next gemacht wurde. Dem Attribut kann auch eine Priorität mitgegeben werden, falls die Angabe mit einer gegenteiligen Aussage (z.B. innerhalb des Bereichs eine page-break-after-Angabe) kollidieren sollte. Diese Funktion tritt nur in Kraft, wenn der nachfolgende Bereich auf der Following-Sibling-Achse (im FO-Dokument) definiert wird.
keep-with-previous Mit diesem Attribut kann angegeben werden, dass zwischen dem ausgezeichneten Bereich und dem vorstehenden Bereich kein Zeilen-, Spalten- oder Seitenumbruch vorkommen darf. Diese Funktion tritt nur in Kraft, wenn der vorstehende Bereich auf der Preceding-Sibling-Achse (im FO-Dokument) definiert wird. Sie kann mit den Komponentenattributen keep-with-previous.within-line (für Zeilenumbrüche), keep-with-previous.within-column (für Spaltenumbrüche) und keep-with-previous.within-page (für Seitenumbrüche) konkretisiert werden. Die Angabe im Attribut keep-with-previous allein entspricht der Angabe aller drei Komponentenattribute mit dem gleichen Wert. Wird das Attribut keep-with-previous in Kombination mit einem Komponentenattribut angegeben, gilt es für die jeweils anderen beiden Komponenten. Dem Attribut kann auch eine Priorität mitgegeben werden, falls die Angabe mit einer gegenteiligen Aussage (z. B. innerhalb des Bereichs eine page-break-after-Angabe) kollidieren sollte.
keep-with-previous.within-column Mit diesem Attribut kann angegeben werden, dass zwischen dem ausgezeichneten Bereich und dem vorstehenden Bereich kein Spaltenumbruch vorkommen darf. Dieses spezielle Attribut überschreibt die Angabe, die im allgemeinen Attribut keep-with-previous gemacht wurde. Dem Attribut kann auch eine Priorität mitgegeben werden, falls die Angabe mit einer gegenteiligen Aussage (z. B. innerhalb des Bereichs eine page-break-after-Angabe) kollidieren sollte. Diese Funktion tritt nur in Kraft, wenn der vorstehende Bereich auf der Preceding-Sibling-Achse (im FO-Dokument) definiert wird.
keep-with-previous.within-line Mit diesem Attribut kann angegeben werden, dass zwischen dem ausgezeichneten Bereich und dem vorstehenden Bereich kein Seitenumbruch vorkommen darf. Dieses spezielle Attribut überschreibt die Angabe, die im allgemeinen Attribut keep-with-previous gemacht wurde. Dem Attribut kann auch eine Priorität mitgegeben werden, falls die Angabe mit einer gegenteiligen Aussage (z. B. innerhalb des Bereichs eine page-break-after-Angabe) kollidieren sollte. Diese Funktion tritt nur in Kraft, wenn der vorstehende Bereich auf der Preceding-Sibling-Achse (im FO-Dokument) definiert wird.
keep-with-previous.within-page Mit diesem Attribut kann angegeben werden, dass zwischen dem ausgezeichneten Bereich und dem vorstehenden Bereich kein Seitenumbruch vorkommen darf. Dieses spezielle Attribut überschreibt die Angabe, die im allgemeinen Attribut keep-with-previous gemacht wurde. Dem Attribut kann auch eine Priorität mitgegeben werden, falls die Angabe mit einer gegenteiligen Aussage (z. B. innerhalb des Bereichs eine page-break-after-Angabe) kollidieren sollte. Diese Funktion tritt nur in Kraft, wenn der vorstehende Bereich auf der Preceding-Sibling-Achse (im FO-Dokument) definiert wird.
left Dieses Attribut kann einen Bereich am linken Rand in Bezug auf den übergeordneten Bereich beschränken bzw. erweitern. Die Angabe kommt nur zur Wirkung, wenn im Attribut position nicht static angegeben wird. Die anderen Werte von position bestimmen, auf welchen Bereich sich das Attribut left bezieht. Ohne Angabe (0mm) ist der linke Rand gleich dem linken Rand des übergeordneten Bereichs. Bei einer positiven Angabe wird der Bereich entsprechend am linken Rand verringert, bei einer negativen Angabe entsprechend erweitert.
margin Dieses Attribut wird zum gleichzeitigen Setzen des oberen, rechten, unteren und linken Randes bzw. Abstands eines Bereichs zu seinem direkt übergeordneten Blockbereich verwendet. Wird nur ein Wert angegeben, so gilt der Abstand sowohl für den linken (margin-left), den rechten (margin-right), den oberen (margin-top) als auch den unteren (margin-bottom) Abstand. Werden zwei Werte angegeben, so gilt der erste für den Abstand oben und unten (margin-top und margin-bottom) und der zweite für den Abstand links und rechts (margin-left und margin-right). Werden drei Werte angegeben, so gilt der erste für den Abstand oben (margin-top), der zweite für den Abstand links und rechts (margin-left und margin-right) und der dritte für den Abstand unten (margin-bottom). Werden alle vier Werte angegeben, so gilt die übliche Reihenfolge: Abstand oben (margin-top), Abstand rechts (margin-right), Abstand unten (margin-bottom) und Abstand links (margin-left).
margin-bottom Dieses Attribut wird zum Setzen eines unteren Abstands verwendet, den ein Bereich im Verhältnis zu seinem direkt übergeordneten Bereich einnehmen soll. Die anderen Abstände werden mit margin-top (Abstand oben), margin-right (Abstand rechts) und margin-left (Abstand links) angegeben. Wird hier ein Wert angegeben, überschreibt dieser den entsprechenden Wert, der eventuell in margin angegeben wurde.
margin-left Dieses Attribut wird zum Setzen eines linken Abstands verwendet, den ein Bereich im Verhältnis zu seinem direkt übergeordneten Bereich einnehmen soll. Die anderen Abstände werden mit margin-top (Abstand oben), margin-right (Abstand rechts) und margin-bottom (Abstand unten) angegeben. Wird hier ein Wert angegeben, überschreibt dieser den entsprechenden Wert, der eventuell in margin angegeben wurde.
margin-right Dieses Attribut wird zum Setzen eines rechten Abstands verwendet, den ein Bereich im Verhältnis zu seinem direkt übergeordneten Bereich einnehmen soll. Die anderen Abstände werden mit margin-top (Abstand oben), margin-left (Abstand links) und margin-bottom (Abstand unten) angegeben. Wird hier ein Wert angegeben, überschreibt dieser den entsprechenden Wert, der eventuell in margin angegeben wurde.
margin-top Dieses Attribut wird zum Setzen eines oberen Abstands verwendet, den ein Bereich im Verhältnis zu seinem direkt übergeordneten Bereich einnehmen soll. Die anderen Abstände werden mit margin-right (Abstand rechts), margin-left (Abstand links) und margin-bottom (Abstand unten) angegeben. Wird hier ein Wert angegeben, überschreibt dieser den entsprechenden Wert, der eventuell in margin angegeben wurde.
padding Padding ist der Innenabstand eines Bereichs. Der Innenabstand ist hier der Abstand vom Inhalt zum Rahmen. (Der Rahmen muss dabei nicht unbedingt sichtbar sein.) Ein Element kann mit dem padding-Attribut versehen werden, um gleichzeitig den oberen (padding-top), rechten (padding-right), unteren (padding-bottom) und linken (padding-left) Abstand bestimmen zu können. Es können so mit einem übergebenen Wert alle Abstände gleich groß angegeben werden. Durch Leerzeichen voneinander getrennt, können auch mehrere Werte angegeben werden. Werden zwei Werte angegeben, bezieht sich der erste Wert auf den oberen und unteren Abstand und der zweite Wert auf den rechten und linken Abstand. Bei drei Werten bezieht sich der erste Wert auf den oberen, der zweite auf den rechten und linken und der dritte auf den unteren Abstand. Werden vier Werte angegeben, bezieht sich der erste auf den oberen, der zweite auf den rechten, der dritte auf den unteren und der vierte auf den linken Abstand. Alle Wertzuordnungen sind unabhängig von der gewählten Schreibrichtung.
padding-after Padding ist der Innenabstand eines Bereichs. Der Innenabstand ist hier der Abstand vom Inhalt zum Rahmen. (Der Rahmen muss dabei nicht unbedingt sichtbar sein.) Ein Element kann mit dem padding-after-Attribut versehen werden, um den Abstand zum unteren Rand — abhängig jedoch von der im Attribut writing-mode gewählten Schreibrichtung — zu bestimmen. Dies bedeutet bei den Schreibrichtungen lr-tb (in Zeile: links nach rechts, Zeilen: oben nach unten) und rl-tb (in Zeile: rechts nach links, Zeilen: oben nach unten), dass padding-after der Abstand zum unteren Rand bleibt. Jedoch bei der Schreibrichtung tb-rl (in Spalte: oben nach unten, Spalten: rechts nach links) betrifft es den Abstand zum linken Rand. Es betrifft also immer den Rand, der parallel zur Zeile bzw. Spalte verläuft und den Bereich abschließt.
padding-before Padding ist der Innenabstand eines Bereichs. Der Innenabstand ist hier der Abstand vom Inhalt zum Rahmen. (Der Rahmen muss dabei nicht unbedingt sichtbar sein.) Ein Element kann mit dem padding-before-Attribut versehen werden, um den Abstand zum oberen Rand — abhängig jedoch von der im Attribut writing-mode gewählten Schreibrichtung — zu bestimmen. Dies bedeutet bei den Schreibrichtungen lr-tb (in Zeile: links nach rechts, Zeilen: oben nach unten) und rl-tb (in Zeile: rechts nach links, Zeilen: oben nach unten) bleibt padding-before der Abstand zum oberen Rand. Jedoch bei der Schreibrichtung tb-rl (in Spalte: oben nach unten, Spalten: rechts nach links) betrifft es den Abstand zum linken Rand. Es betrifft also immer den Rand, der parallel zur Zeile bzw. Spalte verläuft und den Bereich eröffnet.
padding-bottom Padding ist der Innenabstand eines Bereichs. Der Innenabstand ist hier der Abstand vom Inhalt zum Rahmen. (Der Rahmen muss dabei nicht unbedingt sichtbar sein.) Ein Element kann mit dem adding-bottom-Attribut versehen werden, um den Abstand zum unteren Rand — unabhängig von der im Attribut writing-mode gewählten Schreibrichtung — zu bestimmen. Das Attribut überschreibt alle Angaben aus den Attributen padding, padding-after und padding-after.length (bei den Schreibrichtungen lr-tb und rl-tb).
padding-end Padding ist der Innenabstand eines Bereichs. Der Innenabstand ist hier der Abstand vom Inhalt zum Rahmen. (Der Rahmen muss dabei nicht unbedingt sichtbar sein.) Ein Element kann mit dem padding-end-Attribut versehen werden, um den Abstand zum rechten Rand — abhängig jedoch von der im Attribut writing-mode gewählten Schreibrichtung — zu bestimmen. Dies bedeutet bei der Schreibrichtung rl-tb (in Zeile: rechts nach links, Zeilen: oben nach unten) ist padding-end der Abstand zum linken Rand, bei der Schreibrichtung tb-rl (in Spalte: oben nach unten, Spalten: rechts nach links) betrifft es den unteren Rand und nur bei der Schreibrichtung lr-tb (in Zeile: links nach rechts, Zeilen: oben nach unten) ist es der rechte Rand. Es betrifft also immer den Rand, der am Ende der Zeile bzw. Spalte steht und so einen Zeilen- bzw. Spaltenumbruch erzeugt.
padding-left Padding ist der Innenabstand eines Bereichs. Der Innenabstand ist hier der Abstand vom Inhalt zum Rahmen. (Der Rahmen muss dabei nicht unbedingt sichtbar sein.) Ein Element kann mit dem padding-left-Attribut versehen werden, um den Abstand zum linken Rand — unabhängig von der im Attribut writing-mode gewählten Schreibrichtung — zu bestimmen. Das Attribut überschreibt alle Angaben aus den Attributen padding, padding-start und padding-start.length (bei den Schreibrichtungen lr-tb und rl-tb).
padding-right Padding ist der Innenabstand eines Bereichs. Der Innenabstand ist hier der Abstand vom Inhalt zum Rahmen. (Der Rahmen muss dabei nicht unbedingt sichtbar sein.) Ein Element kann mit dem padding-right-Attribut versehen werden, um den Abstand zum rechten Rand — unabhängig von der im Attribut writing-mode gewählten Schreibrichtung — zu bestimmen. Das Attribut überschreibt alle Angaben aus den Attributen padding, padding-end und padding-end.length (bei den Schreibrichtungen lr-tb und rl-tb).
padding-start Padding ist der Innenabstand eines Bereichs. Der Innenabstand ist hier der Abstand vom Inhalt zum Rahmen. (Der Rahmen muss dabei nicht unbedingt sichtbar sein.) Ein Element kann mit dem padding-start-Attribut versehen werden, um den Abstand zum linken Rand — abhängig jedoch von der im Attribut writing-mode gewählten Schreibrichtung — zu bestimmen. Dies bedeutet bei der Schreibrichtung rl-tb (in Zeile: rechts nach links, Zeilen: oben nach unten), dass padding-start der Abstand zum rechten Rand ist, bei der Schreibrichtung tb-rl (in Spalte: oben nach unten, Spalten: rechts nach links) betrifft es den oberen Rand und nur bei der Schreibrichtung lr-tb (in Zeile: links nach rechts, Zeilen: oben nach unten) ist es der linke Rand. Es betrifft also immer den Rand, der am Anfang der Zeile bzw. Spalte steht.
padding-top Padding ist der Innenabstand eines Bereichs. Der Innenabstand ist hier der Abstand vom Inhalt zum Rahmen. (Der Rahmen muss dabei nicht unbedingt sichtbar sein.) Ein Element kann mit dem padding-top-Attribut versehen werden, um den Abstand zum oberen Rand — unabhängig von der im Attribut writing-mode gewählten Schreibrichtung — zu bestimmen. Das Attribut überschreibt alle Angaben aus den Attributen padding, padding-before und padding-before.length (bei den Schreibrichtungen lr-tb und rl-tb).
page-break-after Dieses Attribut beeinflusst einen Seitenumbruch, der eventuell nach dem ausgezeichneten Bereich erfolgen könnte. Es kann angegeben werden, dass kein Seitenumbruch dem Bereich folgen darf. Sollte kein Seitenumbruch an dieser Stelle vorgesehen sein, wird dieser vermieden, indem z. B. die letzten Zeilen eines Absatzes auf die nächste Seite übertragen werden. Im Gegensatz dazu kann auch ein Seitenumbruch erzwungen werden. Dieser kann einfach ausfallen, aber es kann auch bestimmt werden, ob der Inhalt auf einer rechten (mit ungerader Seitenzahl) oder auf einer linken Seite fortgesetzt werden soll. Diese Funktion wird meistens bei Kapiteln in Büchern angewandt, wenn festgelegt wurde, dass Kapitel immer nur auf der rechten oder nur auf der linken Seite beginnen sollen.
page-break-before Dieses Attribut beeinflusst einen Seitenumbruch, der eventuell vor dem ausgezeichneten Bereich erfolgen könnte. Es kann angegeben werden, dass kein Seitenumbruch direkt dem Bereich vorstehen darf. Sollte kein Seitenumbruch an dieser Stelle vorgesehen sein, wird dieser vermieden, indem z. B. die letzten Zeilen des vorstehenden Absatzes auf die nächste Seite übertragen werden. Im Gegensatz dazu kann auch ein Seitenumbruch erzwungen werden. Dieser kann einfach ausfallen, aber es kann auch bestimmt werden, ob der ausgezeichnete Bereich nur auf einer rechten (mit ungerader Seitenzahl) oder nur auf einer linken Seite stehen darf. Diese Funktion wird meistens bei Kapiteln in Büchern angewandt, wenn festgelegt wurde, dass Kapitel immer auf der rechten oder immer auf der linken Seite beginnen sollen.
page-break-inside Dieses Attribut beeinflusst einen Seitenumbruch, der eventuell innerhalb des ausgezeichneten Bereichs erfolgen könnte. Es kann angegeben werden, dass kein Seitenumbruch im Bereich vorkommen darf. Sollte kein Seitenumbruch an dieser Stelle vorgesehen sein, wird dieser vermieden, indem der gesamte Bereich auf die nächste Seite übertragen wird.
position Dieses Attribut gibt die Art der Positionierung bzw. den Positionierungsbezug des ausgezeichneten Bereichs auf der jeweiligen Seite an. In Kombination mit den Attributen top, right, bottom und left kann eine Positionierung in Relation zu der durch den Textfluss bestimmten Position, zum umschließenden Bereich oder zu der vom Textfluss bestimmenden Seite angegeben werden.
provisional-distance-between-starts Im Element fo:list-block lässt sich hier ein Abstand angeben, der zwischen dem Beginn des Labels und dem Beginn des Rumpfes eines Listenelements eingehalten werden soll.
provisional-label-separation Im Element fo:list-block lässt sich hier ein Abstand angeben, der zwischen dem Ende des Labels und dem Beginn des Rumpfes eines Listenelements eingehalten werden soll.
relative-position Dieses Attribut gibt die Art der Positionierung des ausgezeichneten Bereichs auf der jeweiligen Seite an. Jedoch kann im Gegensatz zu position nur angegeben werden, ob der Bereich statisch eingefügt werden soll oder relativ zum Textfluss positioniert wird. In Kombination mit den Attributen top, right, bottom und left kann eine Positionierung in Relation zu der durch den Textfluss bestimmten Position angegeben werden.
right Mit diesem Attribut kann ein Bereich am rechten Rand in Bezug auf den übergeordneten Bereich beschränkt bzw. erweitert werden. Die Angabe kommt nur zur Wirkung, wenn im Attribut position nicht static angegeben wird. Die anderen Werte von position bestimmen, auf welchen Bereich sich das Attribut right bezieht. Ohne Angabe (0mm) ist der rechte Rand gleich dem rechten Rand des übergeordneten Bereichs. Bei einer positiven Angabe wird der Bereich entsprechend am rechten Rand verringert, bei einer negativen Angabe entsprechend erweitert.
role Mit diesem Attribut lassen sich inhaltsbezogene Bezeichner anlegen, die alternativen Ausgabegeräten (z. B. Tonausgabe) Angaben zum Inhalt des verwendeten XML-Elements liefern.
source-document Mit diesem Attribut kann ein XML-Dokument als Quelldokument gekennzeichnet werden. Sollte das FO-Dokument vom Renderer z. B. bei einer theoretischen Sprachausgabe nicht ausgewertet werden können, so kann dann zusätzlich das Quelldokument hinzugezogen werden. Spielt in der Praxis keine Rolle.
space-after Dieses Attribut legt einen Abstand zum direkt folgenden Bereich fest. Dieser Abstand wird nur gesetzt, wenn auch ein Bereich auf der Following-Sibling-Achse (im FO-Dokument) definiert wird. Wird die Seite nach diesem Bereich umbrochen, so wird der Abstand auf der Folgeseite ignoriert. Es handelt sich um ein Attribut, das mehrere Abstandswerte zusammenfassen kann.
space-after.conditionality Dieses Attribut legt fest, inwiefern der Abstand zum direkt folgenden Bereich, der in space-after angegeben wird, angewandt werden soll, wenn der Bereich durch einen Umbruch in zwei Teilbereiche geteilt wird. Der umbrochene Bereich kann weiterhin als ein Bereich angesehen werden, und dementsprechend wird der Umbruch bzw. werden die Umbrüche ignoriert und nur der Abstand zum direkt folgenden Bereich wird angezeigt. Die einzelnen Teilbereiche können auch als eigenständige Bereiche angesehen werden. So wird jeweils vor einem Umbruch ebenfalls ein solcher Abstand eingefügt.
space-after.maximum Dieses Attribut legt einen maximal erlaubten Abstand zum direkt folgenden Bereich fest. Berechnet der Prozessor die Verteilung der Bereiche auf einer Seite/Spalte automatisch, können so Grenzen gesetzt werden. Der Abstand zum direkt folgenden Bereich wird nur gesetzt, wenn auch ein Bereich auf der Following-Sibling-Achse (im FO-Dokument) definiert wird. Hierbei unterscheidet sich das Attribut von den margin-Attributen.
space-after.minimum Dieses Attribut legt einen minimal erlaubten Abstand zum direkt folgenden Bereich fest. Berechnet der Prozessor die Verteilung der Bereiche auf einer Seite/Spalte automatisch, können so Grenzen gesetzt werden. Der Abstand zum direkt folgenden Bereich wird nur gesetzt, wenn auch ein Bereich auf der Following-Sibling-Achse (im FO-Dokument) definiert wird. Hierbei unterscheidet sich das Attribut von den margin-Attributen.
space-after.optimum Dieses Attribut legt einen optimalen Abstand zum direkt folgenden Bereich fest. Berechnet der Prozessor die Verteilung der Bereiche auf einer Seite/Spalte automatisch, wird möglichst versucht, diesen Abstand zu erhalten. Der Abstand zum direkt folgenden Bereich wird nur gesetzt, wenn auch ein Bereich auf der Following-Sibling-Achse (im FO-Dokument) definiert wird. Hierbei unterscheidet sich das Attribut von den margin-Attributen.
space-after.precedence Wird für einen Bereich eine space-after-Angabe gemacht und für den direkt folgenden Bereich eine space-before-Angabe, bestimmt nur eine der beiden Angaben den Abstand zwischen den beiden Bereichen. Welche der beiden Angaben höhere Priorität hat, wird aus den entsprechenden space-after.precedence- bzw. space-before.precedence-Attributen berechnet. Haben beide Attribute den gleichen Wert, wird immer die space-after-Angabe bevorzugt.
space-before Dieses Attribut legt einen Abstand zum direkt vorangegangenen Bereich fest. Dieser Abstand wird nur gesetzt, wenn auch ein Bereich auf der Following-Sibling-Achse (im FO-Dokument) definiert wird. Wird die Seite nach diesem Bereich umbrochen, so wird der Abstand auf der Folgeseite ignoriert. Es handelt sich um ein Attribut, das mehrere Abstandswerte zusammenfassen kann.
space-before.conditionality Dieses Attribut legt fest, inwiefern der Abstand zum direkt vorstehenden Bereich, der in space-before angegeben wird, angewandt werden soll, wenn der Bereich durch einen Umbruch in zwei Teilbereiche geteilt wird. Der umbrochene Bereich kann weiterhin als ein Bereich angesehen werden, und dementsprechend wird der Umbruch bzw. werden die Umbrüche ignoriert und nur der Abstand zum direkt vorstehenden Bereich wird angezeigt. Die einzelnen Teilbereiche können auch als eigenständige Bereiche angesehen werden. So wird jeweils nach einem Umbruch ebenfalls ein solcher Abstand eingefügt.
space-before.maximum Dieses Attribut legt einen maximal erlaubten Abstand zum direkt vorstehenden Bereich fest. Berechnet der Prozessor die Verteilung der Bereiche auf einer Seite/Spalte automatisch, können so Grenzen gesetzt werden. Der Abstand zum direkt vorstehenden Bereich wird nur gesetzt, wenn auch ein Bereich auf der Preceding-Sibling-Achse (im FO-Dokument) definiert wird. Hierbei unterscheidet sich das Attribut von den margin-Attributen.
space-before.minimum Dieses Attribut legt einen minimal erlaubten Abstand zum direkt vorstehenden Bereich fest. Berechnet der Prozessor die Verteilung der Bereiche auf einer Seite/Spalte automatisch, können so Grenzen gesetzt werden. Der Abstand zum direkt vorstehenden Bereich wird nur gesetzt, wenn auch ein Bereich auf der Preceding-Sibling-Achse (im FO-Dokument) definiert wird. Hierbei unterscheidet sich das Attribut von den margin-Attributen.
space-before.optimum Dieses Attribut legt einen optimalen Abstand zum direkt vorstehenden Bereich fest. Berechnet der Prozessor die Verteilung der Bereiche auf einer Seite/Spalte automatisch, wird möglichst versucht, diesen Abstand zu erhalten. Der Abstand zum direkt vorstehenden Bereich wird nur gesetzt, wenn auch ein Bereich auf der Preceding-Sibling-Achse (im FO-Dokument) definiert wird. Hierbei unterscheidet sich das Attribut von den margin-Attributen.
space-before.precedence Wird für einen Bereich eine space-before-Angabe gemacht und für den direkt vorstehenden Bereich eine space-after-Angabe, bestimmt nur eine der beiden Angaben den Abstand zwischen den beiden Bereichen. Welche der beiden Angaben höhere Priorität hat, wird aus den entsprechenden space-after.precedence- bzw. space-before.precedence-Attributen berechnet. Haben beide Attribute den gleichen Wert, wird immer die space-after-Angabe bevorzugt.
start-indent Dieses Attribut legt für einen Bereich eine Einrückung am Anfang jeder Zeile fest.
top Mit diesem Attribut wird der Abstand festgelegt, den ein positioniertes Objekt (fo:block-container) gemessen vom oberen Rand seines unmittelbar übergeordneten Blockbereichs einnehmen soll.

Unterstützung:

Conformance Level Antenna House FOP RenderX XEP Altsoft XML2PDF Compart DocBridge
Basic J J J J J

XSL-FO Beispiel:

<fo:root font-family="Arial" font-size="10pt" line-height="1.2em" xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:cpfo="http://www.compart.net/xmlns/cpfo" xmlns:svg="http://www.w3.org/2000/svg" xmlns:axf="http://www.antennahouse.com/names/XSL/Extensions">

1.

Bodytext Bodytext Bodytext Bodytext Bodytext Bodytext Bodytext Bodytext Bodytext

2.

Bodytext Bodytext Bodytext Bodytext Bodytext Bodytext Bodytext Bodytext Bodytext

2.1

Bodytext Bodytext Bodytext Bodytext Bodytext Bodytext Bodytext Bodytext Bodytext

</fo:flow>

</fo:root>

Download der Beispiele

Weitere Informationen online zu

Einführung "Listen, Aufzählungen und Beschreibungslisten">

Praxisbeispiel "Listen und Aufzählungen">

Darstellung des Elementes in der XSL-FO-Referenz

In der Ausgabe:

Auszug aus der W3C recommendation:

Tipp der data2type-Redaktion:
Zum Thema XSL-FO bieten wir auch folgende Schulungen zur Vertiefung und professionellen Fortbildung an: