Размещение текста при помощи контейнеров блоков: <fo:block-container>

Размещение текста при помощи контейнеров блоков: <fo:block-container>

Процессоры XSL-FO в одном отношении похожи на браузеры HTML: они вставляют блоки в «поток» (flow) страницы, что означает, что эти блоки могут перемещаться по документу, как в HTML-браузере. С другой стороны, иногда бывает важно поместить элементы в странице на определенные места. И в XSL-FO у вас есть возможность разместить элементы либо в абсолютных координатах страницы, либо в координатах относительно других элементов.

Для демонстрации я воспользуюсь элементом <fo:block-container>, который, как можно предположить, выступает в качестве контейнера блоков. Удобно то, что такие контейнеры блоков поддерживают свойства абсолютного позиционирования, которые сами блоки не поддерживают.

С элементом <fo:block-container> можно применять следующие свойства:

• общие свойства абсолютной позиции: absolute-position, top, right, bottom, left;

• общие свойства границ, заполнения и заднего фона: background-attachment, background-color, background-image, background-repeat, background-position-horizontal, background-position-vertical, border-before-color, border-before-style, border-before-width, border-after-color, border-after-style, border-after-width, border-start-color, border-start-style, border-start-width, border-end-color, border-end-style, border-end-width, border-top-color, border-top-style, border-top-width, border-bottom-color, border-bottom-style, border-bottom-width, border-left-color, border-left-style, border-left-width, border-right-color, border-right-style, border-right-width, padding-before, padding-after, padding-start, padding-end, padding-top, padding-bottom, padding-left, padding-right;

• общие свойства полей для блоков: margin-top, margin-bottom, margin-left, margin-right, space-before, space-after, start-indent, end-indent;

• block-progression-dimension;

• break-after;

• break-before;

• clip;

• display-align;

• height;

• id;

• inline-progression-dimension;

• keep-together;

• keep-with-next;

• keep-with-previous;

• overflow;

• reference-orientation;

• span;

• width;

• writing-mode.

В следующем примере (листинг 12.3) я использую контейнеры блоков как оболочки для блоков, которые я хочу поместить в определенные места страницы

Листинг 12.3. blockcontainer.fo

<?xml version="1.0" encoding="UTF-8"?>

<fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format">

 <fo:layout-master-set>

  <fo:simple-page-master margin-right="20mm" margin-left="20mm"

   margin-bottom="10mm" margin-top="10mm" page-width="300mm"

   page-height="400mm" master-name="page">

   <fo:region-body margin-right="0mm" margin-left="0mm"

    margin-bottom="10mm" margin-top="0mm"/>

   <fo:region-after extent="10mm"/>

  </fo:simple-page-master>

 </fo:layout-master-set>

 <fo:page-sequence master-name="page">

  <fo:flow flow-name="xsl-region-body">

   <fo:block-container height="4cm" width="12cm" top="0cm" left="0cm"

    position="absolute">

    <fo:block text-align="start" line-height="18pt"

     font-family="sans-serif" font-weight="bold" font-size="14pt">

     Starpowder

    </fo:block>

    <fo:block text-align="start" line-height="18pt"

     font-family="sans-serif" font-size="14pt">

     The Starpowder Building:

    </fo:block>

    <fo:block text-align="start" line-height="18pt"

     font-family="sans-serif" font-size="14pt">

     1 Starpowder Avenue

    </fo:block>

    <fo:block text-align="start" line-height="18pt"

     font-family="sans-serif" font-size="14pt">

     New York. NY. 10011

    </fo:block>

   </fo:block-container>

   <fo:block-container height="1cm" width="6cm" top="0cm" left="14cm"

    position="absolute">

    <fo:block text-align="start" line-height="22pt"

     font-family="sans-serif" font-size="23pt">

     Invoice

    </fo:block>

   </fo:block-container>

   <fo:block-container border-color="black" border-style="solid"

    border-width="1pt" height="0.7cm" width="3.5cm" top="1.2cm"

    left="12.0cm" padding="2pt" position="absolute">

    <fo:block text-align="start" line-height="15pt"

     font-family="sans-serif" font-size="12pt">

     Date

    </fo:block>

   </fo:block-container>

   <fo:block-container border-color="black" border-style="solid"

    border-width="1pt" height="0.7cm" width="3.5cm" top="1.9cm"

    left="12.0cm" padding="2pt" position="absolute">

    <fo:block text-align="start" line-height="15pt"

     font-family="sans-serif" font-size="12pt">

     January 1, 2002

    </fo:block>

   </fo:block-container>

   <fo:block-container border-color="black" border-style="solid"

    border-width="1pt" height="0.7cm" width="3.5cm" top="1.2cm"

    left="15.5cm" padding="2pt" position="absolute">

    <fo:block text-align="start" line-height="15pt"

     font-family="sans-serif" font-size="12pt">

     Terms

    </fo:block>

   </fo:block-container>

   <fo:block-container border-color="black" border-style="solid"

    border-width="1pt" height="0.7cm" width="3.5cm" top="1.9cm"

    left="15.5cm" padding="2pt" position="absolute">

    <fo:block text-align="start" line-height="15pt"

     font-family="sans-serif" font-size="12pt">

     Immediate

    </fo:block>

   </fo:block-container>

   <fo:block-container border-color="black" border-style="solid"

    border-width="1pt" height="1.0cm" width="9cm" top="3cm"

    left="0cm" padding="2pt" position="absolute">

    <fo:block text-align="center" line-height="22pt"

     font-family="sans-serif" font-size="18pt">

     Description of Service

    </fo:block>

   </fo:block-container>

   <fo:block-container border-color="black" border-style="solid"

    border-width="1pt" height="4cm" width="9cm" top="4.0cm"

    left="0cm" padding="2pt" position="absolute">

    <fo:block text-align="start" line-height="15pt"

     font-family="sans-serif" font-size="12pt">

    </fo:block>

   </fo:block-container>

   <fo:block-container border-color="black" border-style="solid"

    border-width="1pt" height="1.0cm" width="9cm" top="3cm"

    left="10cm" padding="2pt" position="absolute">

    <fo:block text-align="center" line-height="22pt"

     font-family="sans-serif" font-size="18pt">

     Address for Payment:

    </fo:block>

   </fo:block-container>

   <fo:block-container border-color="black" border-style="solid"

    border-width="1pt" height="4cm" width="9cm" top="4.0cm"

    left="10cm" padding="2pt" position="absolute">

    <fo:block text-align="start" line-height="15pt"

     font-family="sans-serif" font-size="12pt">

    </fo:block>

   </fo:block-container>

  </fo:flow>

 </fo:page-sequence>

</fo:root>

Документ PDF, который процессор fop создаст из blockcontainers.fo, показан на рис. 12.2. Как можно видеть на рисунке, я поместил различные блоки в разные места документа. Некоторые прямоугольники должны быть размещены сразу же поверх других, поэтому в данном случае размещение играет важную роль.

Рис. 12.2. Применение контейнеров блоков 

На самом деле работать с контейнерами блоков просто. Взгляните, например, на прямоугольник «Description of Service» (Описание услуги) на рис. 12.2. Я создал его при помощи двух контейнеров блоков: один из них содержит заголовок «Description of Service», а второй — пустой прямоугольник сразу под первым. Для создания прямоугольника заголовка я применил элемент <fo:block-container>, указав размеры прямоугольника в свойствах height (высота) и width (ширина) и задав границу в свойстве border-width. Положение прямоугольника на странице я задал, установив свойство position в absolute и установив свойства left (левый) и top (верхний) для размещения верхнего левого угла прямоугольника по отношению к верхнему левому углу страницы:

<fo:block-container border-color="black" border-style="solid"

 border-width="1pt" height="1.0cm" width="9cm" top="3cm"

 left="0cm" padding="2pt" position="absolute">

 .

 .

 .

</fo:block-container>

Теперь я могу включить в контейнер блок, содержащий заголовок «Description of Service»:

<fo:block-container border-color="black" border-style="solid"

 border-width="1pt" height="1.0cm" width="9cm" top="3cm"

 left="0cm" padding="2pt" position="absolute">

 <fo:block text-align="center" line-height="22pt"

  font-family="sans-serif" font-size="18pt">

  Description of Service

 </fo:block>

</fo:block-container>

После этого я размещаю пустой прямоугольник сразу под прямоугольником заголовка:

</fo:block-container>

<fo:block-container border-color="black" border-style="solid"

 border-width="1pt" height="1.0cm" width="9cm" top="3cm"

 left="0cm" padding="2pt" position="absolute">

 <fo:block text-align="center" line-height="22pt"

  font-family="sans-serif" font-size="18pt">

  Description of Service

 </fo:block>

</fo:block-container>

<fo:block-container border-color="black" border-style="solid"

 border-width="1pt" height="4cm" width="9cm" top="4.0cm"

 left="0cm" padding="2pt" position="absolute">

 <fo:block text-align="start" line-height="15pt"

  font-family="sans-serif" font-size="12pt">

 </fo:block>

</fo:block-container>

Результат показан на рис. 12.2. Я считаю эту возможность одной из самых важных в XSL-FO: вы можете помещать элементы в точности туда, куда вам нужно. Допустимо полагаться на поток объектов, создаваемый процессором XSL-FO, но иногда требуется расположить объекты в определенном месте, и теперь вы знаете, как это сделать.