XSL-FO region-start 對(duì)象

XSL-FO region-start 對(duì)象

XSL-FO 參考手冊(cè)

XSL-FO 中，頁(yè)面的左側(cè)欄由 region-start 對(duì)象定義。

定義和用法

<fo:region-start> 對(duì)象定義了頁(yè)面的左部區(qū)域（左側(cè)欄）。

XSL-FO 使用下列元素來(lái)定義頁(yè)面的區(qū)域：

• <fo:region-body> 定義了主體區(qū)域
• <fo:region-before> 定義了頂部區(qū)域（頁(yè)眉）
• <fo:region-after> 定義了底部區(qū)域（頁(yè)腳）
• <fo:region-start> 定義了左部區(qū)域（左側(cè)欄）
• <fo:region-end> 定義了右部區(qū)域（右側(cè)欄）

注意：region-before、region-after、region-start 以及 region-end 都是 region-body 的一部分。為了避免 region-body 內(nèi)的文本覆蓋其它區(qū)域的文本， region-body 的邊距至少必須與上述四個(gè)子區(qū)域的尺寸相同。

注意：根據(jù) XSL-FO 1.0 版本的推薦標(biāo)準(zhǔn)，padding 和 border-width 屬性必須為 0。

語(yǔ)法

<fo:region-start>
<!--
Contents:EMPTY
-->
</fo:region-start>

屬性

實(shí)例 1

XSL-FO 使用名為 "Page Masters" 的頁(yè)面模板來(lái)定義頁(yè)面的布局。每個(gè)模板必須擁有一個(gè)唯一的名稱(chēng)：

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

在上面的實(shí)例中，三個(gè) <fo:simple-page-master> 元素，定義了三個(gè)不同的模板。每個(gè)模板（page-master）都有不同的名稱(chēng)。

第一個(gè)模板名為 "intro"。它可作為介紹頁(yè)面的模板使用。

第二個(gè)和第三個(gè)模板名為 "left" 和 "right"。它們可作為偶數(shù)和奇數(shù)頁(yè)碼的頁(yè)面模板使用。

實(shí)例 2

這是從某個(gè) XSL-FO 文檔中提取的一個(gè)片斷：

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

上面的代碼定義了一個(gè)名稱(chēng)為 "A4" 的 "Simple Page Master Template"。

頁(yè)面的寬度是 297 毫米，高度是 210 毫米。

頁(yè)面的四個(gè)邊距（上邊距、下邊距、左邊距、右邊距）均為 1 厘米。

主體的邊距是 3 厘米（四個(gè)邊都是）。

主體的 before、after、start 以及 end 區(qū)均為 2 厘米。

上面的實(shí)例中的主體的寬度可通過(guò)頁(yè)面寬度減去左右邊距以及 region-body 的邊距來(lái)計(jì)算得出：

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

請(qǐng)注意，region（region-start 和 region-end）沒(méi)有被計(jì)算進(jìn)來(lái)。正如之前講解過(guò)的，這些區(qū)（region）是主體的組成部分。

XSL-FO 參考手冊(cè)