XSL-FO 页面

XSL-FO 使用名为 "Page Masters" 的页面模板来定义页面的布局。


XSL-FO 页面模板

XSL-FO 使用名为 "Page Masters" 的页面模板来定义页面的布局。每个模板必须拥有一个唯一的名称:

  1. <fo:simple-page-master master-name="intro">
  2. <fo:region-body margin="5in" />
  3. </fo:simple-page-master>
  4. <fo:simple-page-master master-name="left">
  5. <fo:region-body margin-left="2in" margin-right="3in" />
  6. </fo:simple-page-master>
  7. <fo:simple-page-master master-name="right">
  8. <fo:region-body margin-left="3in" margin-right="2in" />
  9. </fo:simple-page-master>

在上面的例子中,三个 <fo:simple-page-master> 元素,定义了三个不同的模板。每个模板(page-master)都有不同的名称。

第一个模板名为 "intro"。它可作为介绍页面的模板使用。

第二个和第三个模板名为 "left" 和 "right"。它们可被用于偶数和奇数页码的页面。


XSL-FO 页面尺寸

XSL-FO 使用下面的属性来定义页面尺寸:

  • page-width,定义页面的宽度
  • page-height,定义页面的高度

XSL-FO 页面边距

XSL-FO 使用下面的属性定义页面边距:

  • margin-top,定义上边距
  • margin-bottom,定义下边距
  • margin-left,定义左边距
  • margin-right,定义右边距
  • margin,定义所有边的边距

XSL-FO 页面区(Page Regions)

XSL-FO 使用下面的元素来定义页面的区:

  • region-body,定义主体区
  • region-before,定义顶部区 (页眉)
  • region-after,定义底部区 (页脚)
  • region-start,定义左侧区 (左侧栏)
  • region-end,定义右侧区 (右侧栏)

注释:region-before、region-after、region-start 以及 region-end 是主体区的一部分。为了避免主体区的文本覆盖到这些区域,主题区的边距至少要等于其他区的尺寸。

结构如下图:


XSL-FO 实例

这是从某个 XSL-FO 文档中提取的一个片断:

  1. <fo:simple-page-master master-name="A4"
  2. page-width="297mm" page-height="210mm"
  3. margin-top="1cm" margin-bottom="1cm"
  4. margin-left="1cm" margin-right="1cm">
  5. <fo:region-body margin="3cm"/>
  6. <fo:region-before extent="2cm"/>
  7. <fo:region-after extent="2cm"/>
  8. <fo:region-start extent="2cm"/>
  9. <fo:region-end extent="2cm"/>
  10. </fo:simple-page-master>

上面的代码定义了名称为 "A4" 的 "Simple Page Master Template"。

页面的宽度是 297 毫米,高度是 210 毫米。

页面的四个边距均为 1 厘米。

主体的边距是 3 厘米(四个边都是)。

before、after、start 以及 end 区均为 2 厘米。

上面的例子中的主体的宽度可通过页面宽度减去左右边距以及 region-body 的边距来计算得出:

297mm - (2 x 1cm) - (2 x 3cm) = 297mm - 20mm - 60mm = 217mm.

提示:on (region-start 和 region-end) 没有被计算进来。正如之前讲解过的,这些区(region)是主体的组成部分。