Читать онлайн «XSLT». Страница 102

Создание списка: <fo:list-block>

Для начала воспользуйтесь элементом <fo:list-block>, чтобы создать список XSL-FO; этот объект содержит элементы <fo:list-item>, содержащие данные списка.

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

• общие свойства доступа: source-document, role;

• общие звуковые свойства: azimuth, cue-after, cue-before, elevation, pause-after, pause-before, pitch, pitch-range, play-during, richness, speak, speak-header, speak-numeral, speak-punctuation, speech-rate, stress, voice-family, volume;

• общие свойства границ, заполнения и заднего фона: 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;

• break-after;

• break-before;

• id;

• keep-together;

• keep-with-next;

• keep-with-previous;

• provisional-distance-between-starts;

• provisional-label-separation;

• relative-position.

Ниже показано, как начинается список в листинге 12.2. В данном случае я задаю значения для свойства provisional-distance-between-starts, определяющего предпочитаемое расстояние от начального отступа метки элемента списка и начального отступа тела элемента списка, и для свойства provisional-label-separation, определяющего предпочитаемое расстояние между концом метки элемента списка (такой, как маркер или номер) и началом тела элемента списка:

<fo:list-block provisional-label-separation="5mm"

 provisional-distance-between-starts="15mm">

 .

 .

 .

</fo:list-block>

Затем при помощи элемента <fo:list-item> нужно поместить в список метку и тело элемента списка. В каждом элементе списка должен присутствовать один из этих объектов.

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

• общие свойства доступа: source-document, role;

• общие звуковые свойства: azimuth, cue-after, cue-before, elevation, pause-after, pause-before, pitch, pitch-range, play-during, richness, speak, speak-header, speak-numeral, speak-punctuation, speech-rate, stress, voice-family, volume;

• общие свойства границ, заполнения и заднего фона: 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;

• break-after;

• break-before;

• id;

• keep-together;

• keep-with-next;

• keep-with-previous;

• relative-align;

• relative-position.

В lists.fo встречается три элемента <fo:list-item>:

<fo:list-block provisional-label-separation="5mm"

 provisional-distance-between-starts="15mm">

 <fo:list-item line-height="20mm">

  .

  .

  .

 </fo:list-item>

 <fo:list-item line-height="20mm">

  .

  .

  .

 </fo:list-item>

 <fo:list-item line-height="20mm">

  .

  .

  .

 </fo:list-item>

</fo:list-block>

Теперь можно создать метку и добавить данные в каждый элемент списка.

Метка для элемента списка создается элементом <fo:list-item-label>, при помощи которого можно перенумеровать или пометить дело элемента списка.

К элементу <fo:list-item-label> можно применять следующие свойства:

• общие свойства доступа: source-document, role;

• id;

• keep-together.

В lists.fo я использую элементы <fo:block> для отображения номера планеты в качестве метки элемента списка (lists.xsl находит этот номер при помощи <xsl:number> и вставляет его в lists.fo):

<fo:list-block provisional-label-separation="5mm"

 provisional-distance-between-starts="15mm">

 <fo:list-item line-height="20mm">

  <fo:list-item-label>

   <fo:block font-size="36pt" font-family="sans-serif">

    1.

   </fo:block>

  </fo:list-item-label>

  .

  .

  .

 </fo:list-item>

 <fo:list-item line-height="20mm">

  <fo:list-item-label>

   <fo:block font-size="36pt" font-familу="sans-serif">

    2.

   </fo:block>

  </fo:list-item-label>

  .

  .

  .

 </fo:list-item>

 <fo:list-item line height="20mm">

  <fo:list-item-label>

   <fo:block font-size="36pt" font-family="sans-serif">

    3.

   </fo:block>

  </fo:list-item-label>

  .

  .

  .

 </fo:list-item>

</fo:list-block>

Все, что осталось, — добавить в этот список сами данные.

Для включения тела элемента списка служит элемент <fo:list-item-body>. Заметьте, что для форматирования тела элемента списка требуемым вам образом вы можете включить в элемент <fo:list-item-body> объект <fo:block>.

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

• общие свойства доступа: source-document, role;

• id;

• keep-together.

В lists.fo элементы <fo:list-item-body> содержат названия планет:

<fo:list-block provisional-label-separation="5mm"

 provisional-distance-between-starts="15mm">

 <fo:list-item line-height="20mm">

  <fo:list-item-label>

   <fo:block font-size="36pt" font-family="sans-serif">

    1.

   </fo:block>

  </fo:list-item-label>

  <fo:list-item-body>

   <fo:block font-size="36pt" font-family="sans-serif">

    Mercury

   </fo:block>

  </fo:list-item-body>

 </fo:list-item>

 <fo:list-item line-height="20mm">

  <fo:list-item-label>

   <fo:block font-size="36pt" font-family="sans-serif">

    2.

   </fo:block>

  </fo:list-item-label>

  <fo:list-item-body>

   <fo:block font-size="36pt" font-family="sans-serif">

    Venus

   </fo:block>

  </fo:list-item-body>

 </fo:list-item>

 <fo:list-item line-height="20mm">

  <fo:list-item-label>

   <fo:block font-size="36pt" font-family="sans-serif">

    3.

   </fo:block>

  </fo:list-item-label>

  <fo:list-item-body>

   <fo:block font-size="36pt" font-family="sans-serif">

    Earth

   </fo:block>

  </fo:list-item-body>

 </fo:list-item>

</fo:list-block>

На этом завершается список, который был показан на рис. 12.1. Работа со списками приемлема в XSL-FO, но я предпочитаю выводить данные при помощи таблиц или простых блоков. Тем не менее, полезно знать, что списки существуют, и ими можно пользоваться.