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 でなければなりません。
语法
<!--
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>
上記の例では、3 つの <fo:simple-page-master> 要素が、3 つの異なるテンプレートを定義しています。各テンプレート(page-master)にはそれぞれ異なる名前が付いています。
最初のテンプレートの名前は "intro" です。これは紹介ページのテンプレートとして使用できます。
2番目と3番目のテンプレートの名前は "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 ミリメートルです。
ページの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 参考手册 其他扩展