XSL-FO Blocks

XSL-FO output goes into blocks.

XSL-FO Pages, Flow, and Block

"Blocks" of content "Flow" into "Pages" of the output media.

XSL-FO output is normally nested inside <fo:block> elements, nested inside <fo:flow> elements, nested inside <fo:page-sequence> elements:

Block Area Attributes

Blocks are sequences of output in rectangular boxes:

Since block areas are rectangular boxes, they share many common area properties:

• space before and space after
• margin
• border
• padding

The space before and space after is the empty space separating the block from the other blocks.

The margin is the empty area on the outside of the block. 

The border is the rectangle drawn around the external edge of the area. It can have different widths on all four sides. It can also be filled with different colors and background images.

The padding is the area between the border and the content area.

The content area contains the actual content like text, pictures, graphics, or whatever.

Block Margin

• margin
• margin-top
• margin-bottom
• margin-left
• margin-right

Block Border

Border style attributes:

• border-style
• border-before-style
• border-after-style
• border-start-style
• border-end-style
• border-top-style (same as border-before)
• border-bottom-style (same as border-after)
• border-left-style (same as border-start)
• border-right-style (same as border-end)

Border color attributes:

• border-color
• border-before-color
• border-after-color
• border-start-color
• border-end-color
• border-top-color (same as border-before)
• border-bottom-color (same as border-after)
• border-left-color (same as border-start)
• border-right-color (same as border-end)

Border width attributes:

• border-width
• border-before-width
• border-after-width
• border-start-width
• border-end-width
• border-top-width (same as border-before)
• border-bottom-width (same as border-after)
• border-left-width (same as border-start)
• border-right-width (same as border-end)

Block Padding

• padding
• padding-before
• padding-after
• padding-start
• padding-end
• padding-top (same as padding-before)
• padding-bottom (same as padding-after)
• padding-left (same as padding-start)
• padding-right (same as padding-end)

Block Background

• background-color
• background-image
• background-repeat
• background-attachment (scroll or fixed)

Block Styling Attributes

Blocks are sequences of output that can be styled individually:

Font attributes:

• font-family
• font-weight
• font-style
• font-size
• font-variant

Text attributes:

• text-align
• text-align-last
• text-indent
• start-indent
• end-indent
• wrap-option (defines word wrap)
• break-before (defines page breaks)
• break-after (defines page breaks)
• reference-orientation (defines text rotation in 90" increments)

Example

Result:

When you look at the example above, you can see that it will take a lot of code to produce a document with many headers and paragraphs.

Normally XSL-FO document do not combine formatting information and content like we have done here.

With a little help from XSLT we can put the formatting information into templates and write a cleaner content.

You will learn more about how to combine XSL-FO with XSLT templates in a later chapter in this tutorial.

Stylus Studio® XML Development Environment

Stylus Studio® 2010 XML Enterprise Suite raises the bar for productivity in XML development tools. Millions of XML developers and data integration specialists turn to Stylus Studio's comprehensive and intuitive XML toolset to tackle today's advanced XML data transformation and aggregation challenges.

XML Pipeline Editor, Debugger and Code Generator DataDirect XML Converters XQuery Mapper, Editor, Debugger, and Profiler XSLT Mapper, Editor, Debugger, Designer, and Profiler Java and C# for .Net Code Generation XML Schema Designer With Documentation Generator XML Editor With Full XPath Integration Download a free trial now