XSL-FO region-endОбъект

XSL-FO 参考手册Справочное руководство по 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 должны быть как минимум не меньше размеров указанных выше четырёх подобластей.

Примечание:Согласно рекомендации версии XSL-FO 1.0, атрибуты padding и border-width должны быть равны 0.

Синтаксис

<fo:region-end>
<!--
Содержимое: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>

В приведённом выше примере три элемента <fo:simple-page-master> определяют три разных шаблона. Каждый шаблон (page-master) имеет другое имя.

Первый шаблон называется "intro". Его можно использовать в качестве шаблона для страницы введения.

Второй и третий шаблоны называются «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>

Приведённый выше код определяет "Simple Page Master Template" с именем "A4".

Ширина страницы — 297 millimeters, а высота — 210 millimeters.

Четыре поля страницы (верхнее поле, нижнее поле, левое поле, правое поле) все равны 1 сантиметру.

Отступы body составляют 3 centimeters (со всех четырёх сторон).

Области before, after, start и end у body все равны 2 centimeters.

Ширину body в приведённом выше примере можно вычислить, вычтя левый и правый отступы и отступы region-body из ширины страницы:

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

Обратите внимание, что области (region-start и region-end) не включены в расчёт. Как объяснялось ранее, эти области являются частью основной области.

XSL-FO 参考手册Справочное руководство по XSL-FO Другие расширения