background-position

(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: 7.31.2

Kategorie: 7.31 Shorthand Properties

Beschreibung

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">

Werte

percentage Die Hintergrundgrafik wird relativ zur Gesamthöhe bzw. -breite des Bereichs um den angegebenen Wert (gerechnet vom linken oberen Rand aus) verschoben. Der Wert muss in Form einer (negativen) (Dezimal-)Zahl und des Prozentzeichens (%) angegeben werden.
length Die Hintergrundgrafik wird um den angegebenen Wert (gerechnet vom linken oberen Rand aus) verschoben. Der Wert muss in Form einer (negativen) (Dezimal-)Zahl und eines dazugehörigen Einheitenbezeichners (em, ex, px, pt, in, cm, mm, pc) angegeben sein.
left Die Hintergrundgrafik wird im umgebenden Bereich am linken Rand ausgerichtet.
center Die Hintergrundgrafik wird im umgebenden Bereich mittig zentriert. Je nachdem, ob diese Angabe als erster Wert angegeben ist oder, wenn vorhanden, als zweiter, bezieht sich dieser Wert auf die horizontale und/oder vertikale Positionierung.
right Die Hintergrundgrafik wird im umgebenden Bereich am rechten Rand ausgerichtet.
bottom Die Hintergrundgrafik wird im umgebenden Bereich am unteren Rand ausgerichtet.
top Die Hintergrundgrafik wird im umgebenden Bereich am oberen Rand ausgerichtet.
Vererbt: ja

Standardwert: 0% 0%

XSL-FO Version: 1.0

Erlaubt in:

<fo:basic-link> , <fo:block> , <fo:block-container> , <fo:character> , <fo:external-graphic> , <fo:initial-property-set> , <fo:inline> , <fo:inline-container> , <fo:instream-foreign-object> , <fo:leader> , <fo:list-block> , <fo:list-item> , <fo:page-number> , <fo:page-number-citation> , <fo:page-number-citation-last> , <fo:region-after> , <fo:region-before> , <fo:region-body> , <fo:region-end> , <fo:region-start> , <fo:scaling-value-citation> , <fo:table> , <fo:table-and-caption> , <fo:table-body> , <fo:table-caption> , <fo:table-cell> , <fo:table-column> , <fo:table-footer> , <fo:table-header> , <fo:table-row> und <fo:title>

Unterstützung:

Conformance Level Antenna House FOP RenderX XEP Altsoft XML2PDF Compart DocBridge
Complete 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">

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.

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

In der Ausgabe:

Auszug aus der W3C recommendation:

Weitere Informationen online zu

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