XSLT - Стивен Холзнер

Этот документ показан на рис. 8.3.

Рис. 8.3. Задание десятичных форматов

Вот и все — теперь вы можете задавать параметры форматирования для функции format-number.

Новые функции в XSLT 2.0 и XPath 2.0

В XSLT 2.0 и XPath 2.0 планируется включить весьма много функций. В частности, для XSLT 2.0 внесены в план следующие положения:

• должны быть включены функции, которые могут работать с QName, для того, чтобы можно было применить объявления пространств имен из области видимости;

• должны быть добавлены функции форматирования даты для поддержки схемы XML;

• должна быть включена функция для преобразования относительных идентификаторов URI в абсолютные;

• должны быть включены функции, упрощающие группировку. В XSLT 2.0 должно быть возможно группировать узлы на основе их строковых значений.

В XPath 2.0 в отношении функций планируются следующие изменения:

• должен быть расширен набор агрегирующих функций — например, включены функции минимума и максимума; 

• для наборов узлов должны быть реализованы функции пересечения и разности; 

• должна быть включена поддержка дополнительных строковых функций, таких как функции для замены строк, заполнения символами и преобразований регистров в строках;

• должны быть включены агрегирующие функции для работы с коллекциями такими как наборы узлов;

• должны быть определены функции для работы со стандартными типами схемы XML.

На этом мы заканчиваем рассмотрение функций XSLT и XPath, применяемых при преобразованиях. В главе 9 мы изучим переменные, параметры и другие специальные темы. 

Глава 9

Именованные шаблоны, параметры и переменные

В этой главе рассматривается ряд специальных возможностей XSLT, а именно шаблоны, параметры таблиц стилей и переменные. Все эти темы связаны друг с другом: параметры используются в именованных шаблонах, а переменные и параметры — это практически одно и то же, они различаются только способом создания.

Если задать шаблону имя, его можно вызывать по этому имени при помощи элемента <xsl:call-template>. Шаблон применяется при вызове, поэтому вместо того чтобы полагаться на обработку таблицы стилей, принятую в процессоре XSLT по умолчанию, вы можете явно задать, когда и какой шаблон нужно применять. Например, несколько шаблонов могут выбирать один и тот же набор узлов, и вам нужно выбрать из них один или несколько шаблонов, которые будут применены. Именованные шаблоны похожи на режимы, но дают вам больше возможностей управления.

При вызове шаблона можно настроить его работу при помощи параметров. Например, вам может понадобиться, чтобы текст в создаваемых шаблоном текстовых узлах был на определенном языке — таком как английский, немецкий или французский — и вы можете создать новый параметр с именем language (язык). При вызове именованного шаблона, заданного для обработки этого параметра, вы можете установить язык в «en», «de» или «fr» и затем вызвать шаблон при помощи элемента <xsl:with-param>. В самом именованном шаблоне используемый им параметр language объявляется при помощи элемента <xsl:param>. После объявления параметра к его значению можно свободно обращаться как $language и использовать его в выражениях XPath. В этой главе мы рассмотрим многочисленные примеры работы с параметрами.

Переменные во многом похожи на параметры, с тем лишь отличием, что они по-другому создаются. Параметры, как правило, используются в именованных шаблонах, в то время как переменные применяются более широко, в выражениях XPath любого вида. Как и в языках программирования, в переменных XSLT можно хранить значения и обращаться к ним позже. Но есть одна важная особенность: за исключением особых обстоятельств, вы не можете изменять значение, хранимое в переменной. (В связи с этим некоторые авторы, пишущие об XSLT, считают неправильным называть их переменными.)

Переменные удобны для хранения значений, создание которых занимает длительное время, но в таблице стилей они часто используются. Вместо того, чтобы каждый раз заново создавать эти значения, сохраните их в переменной и ссылайтесь на ее значение. Как и в случае с параметрами, для получения значения переменной добавьте префикс «$». Например, для переменной с именем sandwich получить ее значение можно при помощи $sandwich. Как и в параметрах, в переменных можно хранить данные всех четырех типов данных XPath. Переменные также имеет смысл применять для хранения значений, которые позже в шаблоне будут изменены. Например, «.» обычно ссылается на контекстный узел шаблона, но внутри элемента <xsl:for-each> «.» ссылается на текущий обрабатываемый в элементе узел, а не на контекстный узел всего шаблона. Для того чтобы обратиться к контекстному узлу, перед входом в цикл <xsl:for-each> сохраните его в переменной contextnode и затем в теле цикла используйте это значение как $contextnode.

Кроме четырех типов данных XPath мы также будем использовать тип данных, поддерживаемый в XSLT 1.0, но не в XSLT 1.1 — фрагменты результирующего дерева, которые создаются элементами <xsl:variable> или <xsl:with-param>. Фрагменты результирующего дерева могут быть удобны в определенных случаях, как вы увидите далее в этой главе.

Наконец, в этой главе мы также рассмотрим элемент <xsl:key>. Впервые он нам встретился в главе 4, теперь мы изучим его более подробно.

Для введения вполне достаточно; давайте перейдем к работе, и начнем мы с переменных.

Элемент <xsl:variable>: создание переменных

Для создания переменных в XSLT служит элемент <xsl:variable>, обладающий следующими атрибутами:

• name (обязательный). Имя переменной, устанавливается в QName;

• select (необязательный). Выражение XPath, задающее значение переменной. Если опустить этот атрибут, значение переменной будет определяться содержимым <xsl:variable>.

Этот элемент может либо быть элементом верхнего уровня, либо применяться внутри тела шаблона. Элемент может сам содержать тело шаблона, но в таком случае нельзя использовать атрибут select.

Для создания переменной присвойте ее имя атрибуту name элемента <xsl:variable>, а значение переменной атрибуту select, как в следующем примере, в котором я создаю переменную number_books и сохраняю в ней значение 255: 

<xsl:variable name="number_books" select="255"/>

.

.

.

Получить значение переменной можно, добавив к ее имени префикс $:

<xsl:variable name="number=books" select="255"/>

<xsl:text>There are </xsl:text>

<xsl:value-of select="$number books"/>

<xsl:text> books in my library </xsl:text>

Заметьте, что если вы присваиваете переменной литерал — как, например, присваивание значения «turkey» (индейка) переменной sandwich (бутерброд), — литерал необходимо заключить в кавычки, причем они должны отличаться от кавычек, в которые заключены значения атрибутов:

<xsl:variable name="sandwich" select="'turkey'"/>

В XSLT 1.0 нет необходимости в атрибуте select — данные можно заключить внутри самого элемента <xsl:variable>:

<xsl:variable name="sandwich">turkey</xsl:variable>

Формально, однако, при пропуске атрибута select в элементах <xsl:variable> или <xsl:with-param> и задании этим элементам содержимого вы создаете фрагмент результирующего дерева, который больше не допускается в XSLT 1.1.

Стоит отметить, что имя переменной может включать префикс, как, например, star:PLANET, который должен соответствовать активному пространству имен. Сравнения осуществляются не сравнением префиксов, а проверкой фактического URI префикса — поэтому star:PLANET может быть тем же самым, что и nebula:PLANET, если пространства имен star и nebula соответствуют одному и тому же URI.

Область видимости переменной

Элемент <xsl:variable> можно использовать как элемент верхнего уровня или внутри тела шаблона для создания переменных. Переменные, созданные в элементах <xsl:variable> высокого уровня, обладают глобальной областью видимости, созданные в телах шаблона — локальной. Область видимости переменной определяет, в какой части таблицы стилей вы можете ее использовать.

Областью видимости глобальной переменной является вся таблица стилей, подразумевая и импортированные или включенные таблицы стилей. Это означает, что переменная доступна в любом месте таблицы стилей, если только она не будет перекрыта локальной переменной с тем же именем. Можно даже обращаться к глобальной переменной до ее объявления. Однако нельзя создавать циклические ссылки (то есть если вы объявили a через b, нельзя объявлять b через а).