XSL-FO region-startオブジェクト

XSL-FO 参考手册

定義と用法

<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 の余白は少なくとも上記の4つのサブ領域のサイズと同じでなければなりません。

注意:XSL-FO 1.0 版の勧告標準によれば、padding および border-width プロパティは 0 でなければなりません。


语法

<fo:region-start>
<!--
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: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>

上記の例では、3 つの <fo:simple-page-master> 要素が、3 つの異なるテンプレートを定義しています。各テンプレート(page-master)にはそれぞれ異なる名前が付いています。

最初のテンプレートの名前は "intro" です。これは紹介ページのテンプレートとして使用できます。

2番目と3番目のテンプレートの名前は "left" と "right" です。これらは偶数および奇数ページ番号のページテンプレートとして使用できます。

实例 2

これは特定の XSL-FO ドキュメントから抽出された断片です:

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

上記のコードは、「A4」という名前の「Simple Page Master Template」を定義しています。

ページの幅は 297 ミリメートル、高さは 210 ミリメートルです。

ページの4つの余白(上余白、下余白、左余白、右余白)はすべて 1 センチメートルです。

本体の余白は 3 センチメートルです(4辺すべて)。

本文のbefore、after、start、およびend領域はすべて2センチメートルです。

上記の例における本文領域の幅は、ページ幅から左右の余白と region-body の余白を差し引いて計算できます。

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

注意:region(region-start および region-end)は計算に含まれていません。以前説明したように、これらの region は本体の構成要素です。


XSL-FO 参考手册 其他扩展