Создание списка: <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> нужно поместить в список метку и тело элемента списка. В каждом элементе списка должен присутствовать один из этих объектов.
С элементом <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>, при помощи которого можно перенумеровать или пометить дело элемента списка.
К элементу <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: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, но я предпочитаю выводить данные при помощи таблиц или простых блоков. Тем не менее, полезно знать, что списки существуют, и ими можно пользоваться.
