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

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

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

Синтаксис

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

В приведенном выше примере три элемента <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 миллиметров, а высота — 210 миллиметров.

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

Отступ body равен 3 сантиметрам (со всех четырёх сторон).

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

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

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

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

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