Форматирующие свойства XSL-FO

We use cookies. Read the Privacy and Cookie Policy

Форматирующие свойства XSL-FO

Форматирующие свойства XSL-FO настраивают действия перечисленных в предыдущем разделе форматирующих объектов; работайте с ними в документах XSL-FO так же, как с атрибутами элементов. Например, вот как я установил семейство (family), размер (size) и насыщенность (weight;) шрифта для текста в блоке:

<fo:block color="blue" font-family="Times"

 font-size="36pt" font-weight="bold">

 Hello from XSL-FO!

</fo:block>

Полный список свойств XSL-FO и их описание можно найти по адресу www.w3.org/TR/xsl/slice7.html. Многие свойства XSL-FO унаследованы из спецификации для каскадных таблиц стилей версии 2, CSS2, которую вы можете найти по адресу www.w3.org/TR/REC-CSS2.

В следующем списке перечислен ряд наиболее распространенных свойств XSL-FO. Полный список свойств (весьма длинный) приведен в Приложении Б. В списке используется следующий синтаксис, соответствующий спецификации XSL-FO:

• <> обозначает единицы значений (см. таблицу 11.1) или свойства (например, <color>), которые уже были определены;

• | означает вариант выбора, использовать можно только один из них;

• || означает вариант выбора, можно использовать один или несколько вариантов в любом порядке;

• [] означает групповые инструкции, вычисляемые во многом так же, как и математические выражения;

• * означает, что предыдущий терм может встречаться ноль или более раз;

• + означает, что предыдущий терм может встречаться один или более раз;

• ? означает, что предыдущий терм необязателен;

• {} окружают пары чисел, задающие минимальное и максимальное число раз встречи терма (как в {1, 4});

Во многих свойствах XSL-FO определен определенный формат для присваиваемых им значений, как, например <color> или <angle>, — эти форматы и их описание перечислены в табл. 11.1.

Таблица 11.1. Форматы спецификации XSL-FO

Формат Описание <absolute-size> Абсолютные размеры шрифта; могут быть xx-small, x-small, small (маленький), medium (средний), large (крупный), x-large, xx-large <angle> Углы; могут измеряться в deg (градусах), grad (градах) или rad (радианах) idctlpar<border-style> Граница прямоугольника, может принимать значения none (нет), dotted (пунктиром), dashed (штрихами), solid (непрерывная), double (двойная), groove (канавкой), ridge (с толстой кромкой), inset (вложенная) или outset (вынесенная) <border-width> Устанавливает ширину границы; может принимать значения thin (тонкая), medium (средняя), thick (толстая) или конкретного размера <color> Цвет; может быть задан предопределенным значением цвета или тройным цветовым значением RGB, как в HTML, — например, «FFFFFF» для белого цвета <country-language> Устанавливается в значение <language> (см. <language>) <family-name> Название семейства шрифтов — такого, как Arial, Times New Roman или Courier <frequency> Значения частоты; единицами измерения могут быть Hz (Гц) или KHz (кГц) <generic-family> Обобщенные названия шрифтов, применяемых в качестве последней попытки, если браузер не может найти определенный шрифт. Например, serif (браузер должен выбрать шрифт serif), sans-serif (браузер должен выбрать семейство sans-serif) и monospace (браузер должен выбрать моноширинный шрифт) <generic-voice> Звук голоса; может быть male (мужской), female (женский) или child (детский) <integer> Стандартные целые значения <keep> Контекстно-зависимое свойство; принимает значение Auto, для того чтобы не удерживать вместе ограничения, или Always для жесткого удержания ограничений вместе. Дополнительная информация приведена в спецификации XSL <language> Определитель языка, соответствующий спецификации RFC1766 (которую можно найти по адресу www.w3.org/TR/xsl/sliceD.html#RFC1766) <length> Длина; может начинаться с + или -, за которыми следует число. Число может содержать десятичную точку, за которой следует идентификатор единиц, принимающий значения em (размер шрифта соответствующего шрифта), ex (x-height, высота шрифта), рх (пикселов, pixel, определяется устройством просмотра), pt (пунктов, point, 1/72 дюйма), in (дюймов, inch), cm (сантиметров), mm (миллиметров) или pc (пик, pica, 1/6 дюйма) <length-bp-ip-direction> Задает расстояние, разделяющее смежные границы ячейки в направлении размещения строк. Дополнительная информация приведена на www.w3.org/TR/xsl/slice7.html <length-conditional> Составное значение, задающее ширину и возможный тип передней границы. Дополнительная информация приведена на www.w3.org/TR/xsl/slice7.html#pr-section <length-range> Определяет диапазон длины, как определено в спецификации XSL <margin-width> Может принимать значения <length>, <percentage> или auto. Работа значения auto зависит от контекста, подробности приведены на www.w3.org/TR/REC-CSS2/visudet.html#Computing_widths_and_margins <number> Число, может включать знак и десятичную точку <padding-width> Устанавливается в значение <length> <percentage> Число, которое может содержать знак, за которым следует знак процента (%) <relative-size> Размер шрифта относительно родительского элемента, может быть Larger (больше) или Smaller (меньше) <shape> Пока может задавать только прямоугольник (shape — фигура), как, например: rect(<top> <right> <bottom> <left>) <space> Задает минимальное, оптимальное и максимальное значения для пробела. Подробности см. на www.W3.org/TR/xsl/slice4.html#spacecond <specific-voice> Задает определенный голос. Подробности см. на www.w3.org/TR/REC-CSS2/aural.html#propdef-voice-family <time> Единицы времени, указанные как число, за которым сразу же следует ms (миллисекунды) или s (секунды) <uri-specification> Uniform Resource Indicator (URI); web-адрес элемента страницы такого, как рисунок

Примите также к сведению, что свойства XSL-FO, как и свойства CSS2, могут принимать значение «inherit», что означает, что значение свойства должно быть унаследовано от его родительского элемента.

В следующем списке перечислены наиболее распространенные свойства XSL-FO. Полный список приведен в Приложении Б.

• absolute-position. Определяет, является ли позиция элемента абсолютной. Устанавливается в auto | absolute | fixed | inherit;

• background. Свойство для быстрой установки сразу всех отдельных свойств заднего фона (background-color, background-image, background-repeat, background-attachment и background-position). Устанавливается в [ <background-color> || <background-image> || <background-repeat> || <background-attachment> || <background-position> ] | inherit ;

• background-attachment. Определяет, будет ли прокручиваться задний фон. Устанавливается в scroll | fixed | inherit;

• background-color. Задает цвет заднего фона элемента. Устанавливается в <color> | transparent | inherit;

• background-image. Задает рисунок заднего фона элемента. Устанавливается в <uri-specification> | none | inherit;

• background-repeat. Определяет, может ли рисунок заднего фона располагаться мозаикой, и если да, то каким образом. Устанавливается в repeat | repeat-x | repeat-y | no-repeat | inherit;

• border. Свойство для быстрой установки одинаковых ширины, цвета и стиля всех четырех границ (верхней, нижней, левой и правой) прямоугольника. Устанавливается в [ <border-width> || <border-style> || <color> ] | inherit;

• border-after-color. Задает цвет задней границы области. Устанавливается в <color> | inherit;

• border-after-style. Задает стиль задней границы. Устанавливается в <border- style> | inherit;

• border-after-width. Задает ширину задней границы. Устанавливается в <border-width> | <length-conditional> | inherit;

• border-before-color. Задает цвет передней границы. Устанавливается в <color> | inherit;

• border-before-style. Задает стиль передней границы. Устанавливается в <border-style> | inherit;

• border-before-width. Задает ширину передней границы. Устанавливается в <border-width> | <length-conditional> | inherit;

• border-bottom. Свойство для быстрой установки ширины, стиля и цвета нижней границы области блока или встроенной области. Устанавливается в [ <border-top-width> || <border-style> || <color> ] | inherit;

• border-bottom-color. Задает цвет нижней границы. Устанавливается в <color> | inherit;

• border-bottom-style. Задает стиль нижней границы. Устанавливается в <border-style> | inherit;

• border-bottom-width. Задает ширину нижней границы. Устанавливается в <border-width> | inherit;

• border-collapse. Задает модель границы таблицы. Устанавливается в collapse | separate | inherit;

• border-color. Задает цвет сразу всех четырех границ. Устанавливается в <color>{1,4} | transparent | inherit;

• border-end-color. Задает цвет конечной границы. Устанавливается в <color> | inherit;

• border-end-style. Задает стиль конечной границы. Устанавливается в <border-style> | inherit;

• border-end-width. Задает ширину конечной границы. Устанавливается в <border-width> | <length-conditional> | inherit;

• border-left. Свойство для быстрой установки одновременно ширины, стиля и цвета левой границы. Устанавливается в [ <border-top-width> || <border-style> || <color> ] | inherit;

• border-left-color. Задает цвет левой границы. Устанавливается в <color> | inherit;

• border-left-style. Задает стиль левой границы. Устанавливается в <border-style> | inherit;

• border-left-width. Задает ширину левой границы. Устанавливается в <border-width> | inherit;

• border-right. Свойство для быстрой установки одновременно ширины, стиля и цвета правой границы. Устанавливается в [ <border-top-width> || <border-style> || <color> ] | inherit;

• border-right-color. Задает цвет правой границы. Устанавливается в <color> | inherit;

• border-right-style. Задает стиль правой границы. Устанавливается в <border-style> | inherit;

• border-right-width. Задает ширину правой границы. Устанавливается в <border-width> | inherit;

• border-spacing. Задает расстояние между смежными границами ячейки. Устанавливается в <length> <length>? | inherit;

• border-start-color. Задает цвет начальной границы. Устанавливается в <color>;

• border-start-style. Задает стиль начальной границы. Устанавливается в <border-style> | inherit;

• border-start-width. Задает ширину начальной границы. Устанавливается в <border-width> | <length-conditional> | inherit;

• border-style. Задает стиль четырех границ. Устанавливается в <border-style> {1,4} | inherit;

• border-top. Свойство для быстрой установки одновременно ширины, стиля и цвета верхней границы области блока или встроенной области. Устанавливается в [ <border-top-width> || <border-style> || <color> ] | inherit;

• border-top-color. Задает цвет верхней границы. Устанавливается в <color> | inherit;

• border-top-style. Задает стиль линии границы прямоугольника (непрерывная, двойная, штриховая и т.д.);

• border-top-width. Задает ширину верхней границы. Устанавливается в <border-width> | inherit;

• border-width. Свойство для быстрой установки одновременно свойств border-top-width, border-right-width, border-bottom-width и border-left-width. Устанавливается в <border-width>{1,4} | inherit;

• bottom. Определяет, насколько нижний край содержимого прямоугольника (box) смещен вверх от нижней границы содержащего прямоугольник блока. Устанавливается в <length> | <percentage> | auto | inherit;

• character. Задает вставляемый символ Unicode. Устанавливается в <character>;

• color. Задает цвет переднего фона текста элемента. Устанавливается в <color> | inherit;

• column-count. Задает число столбцов в области. Устанавливается в <number> | inherit;

• column-number. Устанавливает номер столбца для ячеек таблицы. Устанавливается в <number>;

• column-width. Задает ширину такого объекта, как внешняя графика. Устанавливается в auto | scale-to-fit | <length> | <percentage> | inherit;

• float. Определяет, будет ли прямоугольник прижат влево, вправо или вообще не будет прижат. Устанавливается в before | start | end | left | right | none | inherit;

• flow-name. Задает имя потока (flow). Устанавливается в <name>;

• font. Свойство для быстрого задания одновременно свойств font-style, font-variant, font-weight, font-size, line-height и font-family. Устанавливается в [ [ <font-style> || <font-variant> || <font-weight> ]? <font-size> [ / <line-height>]? <font- family> ] | caption | icon | menu | message-box | small-caption | status-bar | inherit;

• font-family. Задает список имен семейств шрифтов и/или обобщенных имен семейств в порядке предпочтения. Устанавливается в [[ <family-name> | <generic-family> ],]* <family-name> | <generic-family>] | inherit;

• font-size. Задает размер шрифта. Устанавливается в <absolute-size> | <relative-size> | <length> | <percentage> | inherit;

• font-style. Задает стиль шрифта. Устанавливается в normal | italic | oblique | backslant | inherit;

• font-variant. Выбирает шрифты, имеющие строчные и прописные буквы (bicameral fonts). Устанавливается в normal | small-caps | inherit;

• font-weight. Задает насыщенность шрифта. Устанавливается в normal | bold | bolder | lighter | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900 | inherit;

• format. Формат XSLT. Устанавливается в <string>;

• grouping-separator. Разделитель групп разрядов формата XSLT. Устанавливается в <character>;

• grouping-size. Размер группы формата XSLT. Устанавливается в <number>;

• height. Задает высоту содержимого прямоугольников, создающихся элементами уровня блока и замещенными элементами. Устанавливается в <length> | <percentage> | auto | inherit;

• initial-page-number. Задает начальный номер страницы. Устанавливается в auto | auto-odd | auto-even | <number> | inherit;

• left. Определяет, насколько левый край содержимого прямоугольника (box) смещен вправо от левой границы содержащего прямоугольник блока. Устанавливается в: <length> | <percentage> | auto | inherit;

• linefeed-treatment. Определяет способ обработки символов перевода строки. Устанавливается в ignore | preserve | treat-as-space | treat-as-zero-width-space | inherit;

• line-height. Задает минимальную высоту каждого созданного встроенного прямоугольника. Устанавливается в normal | <length> | <number> | <percentage> | <space> | inherit;

• margin. Свойство для быстрого задания одновременно свойств полей margin-top, margin-right, margin-bottom и margin-left. Устанавливается в <margin-width> {1,4} | inherit;

• margin-bottom. Задает нижнее поле прямоугольника. Устанавливается в <margin-width> | inherit;

• margin-left. Задает левое поле прямоугольника. Устанавливается в <margin-width> | inherit;

• margin-right. Задает правое поле прямоугольника. Устанавливается в <margin-width> | inherit;

• margin-top. Задает верхнее поле прямоугольника. Устанавливается в <margin-width> | inherit;

• master-name. Задает или выбирает шаблон (master). Устанавливается в <name>;

• number-columns-spanned. Задает число столбцов, занимаемых ячейкой таблицы. Устанавливается в <number>;

• number-rows-spanned. Задает число строк, занимаемых ячейкой таблицы. Устанавливается в <number>;

• page-break-after. То же, что и свойство CSS2 с тем же именем. Устанавливается в auto | always | avoid | left | right | inherit;

• page-break-before. To же, что и свойство CSS2 с тем же именем. Устанавливается в auto | always | avoid | left | right | inherit;

• page-height. Задает высоту страницы. Устанавливается в auto | indefinite | <length> | inherit;

• page-width. Задает ширину страницы. Устанавливается в auto | indefinite | <length> | inherit;

• position. Задает используемую схему размещения. Устанавливается в static | relative | absolute | fixed | inherit;

• relative-position. То же, что и свойство CSS2 с тем же именем. Устанавливается в static | relative | inherit;

• right. Определяет, насколько край содержимого прямоугольника (box) смещен влево от правой границы содержащего прямоугольник блока. Устанавливается в <length> | <percentage> | auto | inherit;

• score-spaces. Определяет, следует ли применять свойство text-decoration к пробелам. Устанавливается в true | false | inherit;

• space-treatment. Определяет способ обработки пробелов и других символов-разделителей, за исключением символов перевода строки. Устанавливается в ignore | preserve | ignore-if-before-linefeed | ignore-if-after-linefeed | ignore-if-surrounding-linefeed | inherit;

• span. Определяет, нужно ли поместить объект уровня блока в текущий столбец или растянуть его на все столбцы в области. Устанавливается в none | all | inherit;

• src. Задает ссылку URI, определяющую внешний ресурс. Устанавливается в <uri-specification> | inherit;

• start-indent. Определяет расстояние от начального края прямоугольника содержимого области, содержащей блок, до начального края прямоугольника содержимого области этого блока. Устанавливается в <length> | inherit;

• starts-row. Определяет, начинает ли эта ячейка строку. Устанавливается в true | false;

• text-align. Определяет способ выравнивания встроенного содержимого блока. Устанавливается в start | center | end | justify | inside | outside | left | right | <string> | inherit;

• text-decoration. Задает параметры оформления, добавляемого тексту элемента. Устанавливается в none | [ [ underline | no-underline] || [ overline | no-overline ] || [ line-through | no-line-through ] || [ blink | no-blink ] ] | inherit;

• text-indent. Определяет выравнивание первой строки текста в блоке. Устанавливается в <length> | <percentage> | inherit;

• text-shadow. Задает разделенный запятыми список теневых эффектов, которые нужно применить к тексту элемента. Устанавливается в none | <color> || <length> <length> <length>? ,]* <color> || <length> <length> <length>?] | inherit;

• top. Определяет, насколько край содержимого смещен ниже верхнего края содержащего его блока. Устанавливается в <length> | <percentage> | auto | inherit;

• vertical-align. Определяет вертикальное расположение. Устанавливается в baseline | middle | sub | super | text-top | text-bottom [ <percentage> | <length> | top | bottom | inherit;

• visibility. Определяет, будут ли отображены генерируемые элементом прямоугольники. Устанавливается в visible | hidden | collapse | inherit;

• white-space. Определяет способ обработки символов-разделителей (white-space) внутри элемента. Устанавливается в normal | pre | nowrap | inherit;

• white-space-collapse. Задает способ обработки последовательных символов-разделителей. Устанавливается в false | true | inherit;

• width. Задает ширину содержимого прямоугольников, созданных элементами уровня блока и замененными элементами. Устанавливается в <length> | <percentage> | auto | inherit;

• wrap-option. Определяет наличие оболочки строк форматирующего объекта. Устанавливается в no-wrap | wrap | inherit.

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

Мы вкратце рассмотрели структуру XSL-FO, теперь пора перейти к практике: сейчас мы подробно рассмотрим работу примера.