fo:change-bar-begin

(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.13.2

Kategorie: 6.13 Other Formatting Objects

Beschreibung

Dieses Element stellt den Anfang eines "Änderungsbereichs" dar, der durch sein passendes fo:change-bar-end beendet wird. Der Änderungsbereich ist mit einem Änderungsbalken ausgestattet, der entweder am Anfang oder am Ende der Spaltenkante entlang verläuft. Das Aussehen des Änderungsbalkens wird durch den Wert einiger entsprechender Eigenschaften bestimmt.

XSL-FO Version: 1.1

Elternelemente

<fo:basic-link> , <fo:bidi-override> , <fo:block> , <fo:block-container> , <fo:float> , <fo:flow> , <fo:folio-prefix> , <fo:folio-suffix> , <fo:footnote-body> , <fo:index-page-citation-list-separator> , <fo:index-page-citation-range-separator> , <fo:index-page-number-prefix> , <fo:index-page-number-suffix> , <fo:inline> , <fo:inline-container> , <fo:leader> , <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> , <fo:title> und <fo:wrapper>

Kindelemente

Attribute

change-bar-class Mit diesem Attribut kann für den Startmarker (change-bar-begin) und den Endmarker (change-bar-end) eines Änderungsbalkens ein Name festgelegt werden. Dieser kann zur Referenzierung verwendet werden. Falls beispielsweise mehrere Änderungsbalken ineinandergreifen, lassen sich so die Markierungen auseinanderhalten.
change-bar-color Mit diesem Attribut kann im Startmarker eines Änderungsbalkens (change-bar-begin) eine Farbe angegeben werden, die ein Änderungsbalken einnehmen soll.
change-bar-offset Mit diesem Attribut kann im Startmarker eines Änderungsbalkens (change-bar-begin) ausgehend vom äußeren senkrechten Rand, in dem sich der Änderungsbalken befindet, ein Abstand angegeben werden.
change-bar-placement Mit diesem Attribut kann im Startmarker eines Änderungsbalkens (change-bar-begin) angegeben werden, an welchem Rand des umgebenden Bereichs der Änderungsbalken dargestellt werden soll.
change-bar-style Mit diesem Attribut kann im Startmarker eines Änderungsbalkens (change-bar-begin) eine Angabe über den Stil festgelegt werden.
change-bar-width Mit diesem Attribut kann im Startmarker eines Änderungsbalkens (change-bar-begin) dessen Dicke festgelegt werden.
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.
z-index Mit diesem Attribut wird die Reihenfolge überlappender Elemente festgelegt. Ein Element mit dem Wert 3 für z-index liegt somit über einem Element mit dem Wert 2. Elemente, die denselben Wert für z-index haben, werden in der Reihenfolge, in der sie im Code erscheinen, dargestellt.

Unterstützung:

Conformance Level Antenna House FOP RenderX XEP Altsoft XML2PDF Compart DocBridge
Extended J N - N N

XSL-FO Beispiel:

Als Gregor Samsa eines Morgens aus unruhigen Träumen erwachte, fand er sich in seinem Bett zu einem ungeheueren Ungeziefer verwandelt.

Er lag auf seinem panzerartig harten Rücken und sah, wenn er den Kopf ein wenig hob,

seinen gewölbten, braunen, von bogenförmigen Versteifungen geteilten Bauch, auf dessen Höhe sich die Bettdecke, zum gänzlichen Niedergleiten bereit, kaum noch erhalten konnte. Seine vielen, im Vergleich zu seinem sonstigen Umfang kläglich dünnen Beine flimmerten ihm hilflos vor den Augen.

»Was ist mit mir geschehen?«, dachte er.

Es war kein Traum. Sein Zimmer, ein richtiges, nur etwas zu kleines Menschenzimmer, lag ruhig zwischen den vier wohlbekannten Wänden. Über dem Tisch, auf dem eine auseinandergepackte Musterkollektion von Tuchwaren ausgebreitet war - Samsa war Reisender - hing das Bild, das er vor kurzem aus einer illustrierten Zeitschrift ausgeschnitten und in einem hübschen, vergoldeten Rahmen untergebracht hatte. Es stellte eine Dame dar, die mit einem Pelzhut und einer Pelzboa versehen, aufrecht dasaß und einen schweren Pelzmuff, in dem ihr ganzer Unterarm verschwunden war, dem Beschauer entgegenhob.

</fo:flow>

</fo:root>

Download der Beispiele

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: