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

XSL-FO 参考手册

定義と用法

<fo:region-end> オブジェクトはページの右部領域(右側の欄)を定義します。

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-end>
<!--
Contents:EMPTY
-->
</fo:region-end>

属性

属性 [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 センチメートルです(四辺すべて)。

本文領域の 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 参考手册 其他扩展