XSL-FO region-start 對象

定義和用法
<fo:region-start> 對象定義了頁面的左部區域(左側欄)。
XSL-FO 使用下列元素來定義頁面的區域:
- <fo:region-body> 定義了主體區域
- <fo:region-before> 定義了頂部區域(頁眉)
- <fo:region-after> 定義了底部區域(頁腳)
- <fo:region-start> 定義了左部區域(左側欄)
- <fo:region-end> 定義了右部區域(右側欄)
注意:region-before、region-after、region-start 以及 region-end 都是 region-body 的一部分。為了避免 region-body 內的文本覆蓋其他區域的文本, region-body 的邊距至少必須與上述四個子區域的尺寸相同。
注意:根據 XSL-FO 1.0 版本的推薦標準,padding 和 border-width 屬性必須為 0。
語法
<!--
Contents:EMPTY
-->
</fo:region-start>
屬性
屬性 [A-B] | 屬性 [C-Z] |
---|---|
background-attachment | clip |
background-color | display-align |
background-image | extent |
background-repeat | overflow |
background-position-horizontal | padding-after |
background-position-vertical | padding-before |
border-after-color | padding-bottom |
border-after-style | padding-end |
border-after-width | padding-left |
border-before-color | padding-right |
border-before-style | padding-start |
border-before-width | padding-top |
border-bottom-color | region-name |
border-bottom-style | reference-orientation |
border-bottom-width | writing-mode |
border-end-color | |
border-end-style | |
border-end-width | |
border-left-color | |
border-left-style | |
border-left-width | |
border-right-color | |
border-right-style | |
border-right-width | |
border-start-color | |
border-start-style | |
border-start-width | |
border-top-color | |
border-top-style | |
border-top-width |
實例 1
XSL-FO 使用名為 "Page Masters" 的頁面範本來定義頁面的佈局。每個範本必須擁有一個唯一的名稱:
<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>
在上面的實例中,三個 <fo:simple-page-master> 元素,定義了三個不同的範本。每個範本(page-master)都有不同的名稱。
第一個範本名為 "intro"。它可作為介紹頁面的範本使用。
第二個和第三個範本名為 "left" 和 "right"。它們可作為偶數和奇數頁碼的頁面範本使用。
實例 2
這是從某個 XSL-FO 文檔中提取的一個片斷:
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>
上面的代碼定義了一個名稱為 "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
請注意,region(region-start 和 region-end)沒有被計算進來。正如之前講解過的,這些區(region)是主體的組成部分。
