XSL-FO region-start Object
Definition and Usage
The <fo:region-start> object defines the left region of a page (left
sidebar).
XSL-FO uses the following elements to define the regions of a page:
- <fo:region-body> defines the body region
- <fo:region-before> defines the top region (header)
- <fo:region-after> defines the bottom region (footer)
- <fo:region-start> defines the left region (left sidebar)
- <fo:region-end> defines the right region (right sidebar)
Note: region-before, region-after, region-start, and region-end is a
part of the region-body. To avoid text in the region-body to overwrite text in
the other regions, the region-body must have margins at least the size of these
regions.
Note: According to version 1.0 of the XSL-FO Recommendation, the
padding and border-width properties must be 0.
Syntax
<fo:region-start>
<!--
Contents:EMPTY
-->
</fo:region-start>
|
Properties
Example 1
XSL-FO uses page templates called "Page Masters" to define the layout of
pages. Each template
must have a unique name:
<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>
|
In the example above, three <fo:simple-page-master> elements, define three
different templates. Each template (page-master) has a different name.
The first template is called "intro". It could be used as a template for
introduction pages.
The second and third templates are called "left" and "right". They could be
used as templates for even and odd page numbers.
Example 2
This is an extract from an XSL-FO document:
<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>
|
The code above defines a "Simple Page Master Template" with the name "A4".
The width of the page is 297 millimeters and the height is 210 millimeters.
The top, bottom, left, and right margins of the page are all 1 centimeter.
The body has a 3 centimeter margin (on all sides).
The before, after, start, and end regions (of the body) are all 2
centimeters.
The
width of the body in the example above can be
calculated by subtracting the left and right margins and the region-body
margins from the width of the page itself:
297mm - (2 x 1cm) - (2 x 3cm) = 297mm - 20mm - 60mm = 217mm.
Note that the regions (region-start and region-end) are not a part of the
calculation. As described earlier, these regions are parts of the body.
Need an easy way to get data into XML, or transform XML to another format?
MapForce lets you map XML data to/from any combination of XML, database, flat file, Excel 2007, XBRL, or Web services data.
Then it transforms data instantly or auto-generates royalty-free data integration code for recurrent conversions.
Download a free, fully functional 30-day trial to experience the following features:
- Easy-to-use, graphical data mapping interface
- Instant data transformation
- XSLT 1.0/2.0 and XQuery code generation
- Java, C#, and C++ code generation
- Advanced data processing functions
- Support for all major relational databases including SQL Server, IBM DB2, Oracle, and more
- Visual Studio & Eclipse integration
Download a fully-functional trial today!
|
|
|
| 
