Стандартный механизм использования xml-stylesheet может быть продемонстрирован следующим документом:
<?xml version="1.0"?>
<?xml-stylesheet type="text/xsl" href="mytransform.xsl"?>
<body>
<!-- ... -->
</body>
В этом документе инструкция xml-stylesheet указывает на то, что этот документ должен быть обработан XSLT-преобразованием mytransform.xsl.
Псевдоатрибут title может содержать краткое описание применяемого преобразования:
<?xml-stylesheet
title="Generate menu"
type="text/xsl"
href="menu.xsl"?>
Псевдоатрибуты media и alternate могут использоваться совместно для того, чтобы описать альтернативное представление документа, к примеру, на небольших мобильных устройствах:
<?xml-stylesheet
type="text/xsl"
href="pda.xsl"
alternate="yes"
media="handheld"?>
Теоретически, если документ с такой инструкцией будет показываться на мобильном устройстве (например, на Palm Pilot), он должен быть преобразован при помощи pda.xsl. На практике не следует полагаться на подобные возможности, поскольку они сильно зависят от поддержки серверов и процессоров, которая в этом отношении все еще сильно ограничена.
В заключение описания инструкции xml-stylesheet приведем правила, которые определяют ее синтаксис.
[XMS1] StyleSheetPI ::= '<?xml-stylesheet' (S PseudoAtt)* S? '?>'
[XMS2] PseudoAtt ::= Name S? '=' S? PseudoAttValue
[XMS3] PseudoAttValue ::= ( '"' ([^"<&]|CharRef|PredefEntityRef)* '"'
| "'" ([^'<&]|CharRef|PredefEntityRef)* "'")
- (Char* '?>' Char*)
[XMS4] PredefEntityRef ::= '"' | '<'
| '>' | '&' | '''
Объединение документа и преобразования
XSLT-преобразование является, как правило, самостоятельным XML-документом, корневым элементом которого является xsclass="underline" stylesheet или xsclass="underline" transform. Вместе с тем, иногда бывает необходимо объединять преобразуемый документ и само преобразование так, чтобы они находились в одном файле.
Мы опишем два способа объединения документов и преобразований. Первый основывается на использовании инструкции xml-stylesheet для того, чтобы закрепить за документом преобразование, находящееся внутри него самого. Во втором способе обрабатываемый документ включается в преобразование как пользовательский элемент верхнего уровня и обрабатывается при помощи функции document('') с пустым строковым параметром.
Включение преобразования в документ
Корневой элемент преобразования xsclass="underline" stylesheet может быть включен в преобразуемый документ со всеми дочерними элементами верхнего уровня и так далее. Для того чтобы использовать это преобразование, псевдоатрибут href инструкции по обработке xml-stylesheet должен указывать на идентификатор элемента xsclass="underline" stylesheet, определенный в его атрибуте id.
<?xml version="1.0"?>
<?xml-stylesheet type="text/xml" href="#transform"?>
<page>
<title>Main page</title>
<content>Main content</content>
<xsclass="underline" stylesheet
id="transform"
version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsclass="underline" template match="/">
<body title="{page/title}">
<xsclass="underline" text><xsclass="underline" value-of select="page/content"/></xsclass="underline" text>
</body>
</xsclass="underline" template>
<xsclass="underline" template match="xsclass="underline" stylesheet"/>
</xsclass="underline" stylesheet>
</page>
<body title="Main page">
Main content
</body>
Поскольку элемент xsclass="underline" stylesheet включен в преобразуемый документ, он также подвергнется преобразованию. Для того чтобы избежать этого, в преобразование включается шаблонное правило, которое указывает, что элементы xsclass="underline" stylesheet следует игнорировать:
<xsclass="underline" template match="xsclass="underline" stylesheet"/>
К сожалению, приходится констатировать тот факт, что описанную возможность (хотя она и включена в спецификацию языка XSLT) поддерживают очень немногие процессоры и поэтому пока что на нее не следует полагаться.
Включение документа в преобразование
Другой возможностью объединения документов и преобразований является включение элемента документа в преобразование в виде элемента верхнего уровня.
Поскольку преобразование также является XML-документом, доступ к данным, которые оно содержит можно получить при помощи функции document, так же, как если бы документ преобразования был внешним документом. Функция document, которой в качестве параметра была передана пустая строка, возвращает множество, состоящее из корневого узла самого преобразования. То есть, если документ был включен в преобразование в качестве элемента верхнего уровня с именем, к примеру, user:input, получить доступ к нему можно при помощи выражения
document('')/xsclass="underline" stylesheet/user:input
<whatever/>
<xsclass="underline" stylesheet
version="1.0"
xmlns:user="urn:user"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
exclude-result-prefixes="user">
<input xmlns="urn:user">
<a/>
<b/>
</input>
<xsclass="underline" template match="/">
<xsclass="underline" apply-templates
select="document('')/xsclass="underline" stylesheet/user:input"/>
</xsclass="underline" template>
<xsclass="underline" template match="user:a">
<A/>
</xsclass="underline" template>
<xsclass="underline" template match="user:b">
<B/>
</xsclass="underline" template>
<xsclass="underline" template match="user:input">
<output>
<xsclass="underline" apply-templates/>