Алексей Валиков - Технология XSLT

xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

Элемент xsl:attributeне может использоваться где угодно: узлы атрибутов должны создаваться только как дочерние узлы узлов элементов. Более того, узлы атрибутов должны создаваться до создания дочерних узлов других типов — текста, элементов и так далее. Таким образом, xsl:attributeможет быть использован в содержимом любого из следующих родителей:

□ литерального элемента результата;

□ элемента xsl:element;

□ элемента xsl:copyв случае, если текущий, копируемый узел является элементом;

□ элемента xsl:attribute-setв случае определения именованного набора атрибутов.

При этом, как было показано в предыдущем примере, xsl:attributeне обязан использоваться только в качестве их непосредственного дочернего элемента. Главное, чтобы атрибуты создавались в элементах и только в элементах.

Элемент xsl:attributeтакже не может использоваться для генерации объявлений пространств имен. В соответствии с технической рекомендацией XSLT, xsl:attributeне может создавать атрибуты, имена которых имеют префикс xmlns.

Если атрибут создается в элементе, который уже имеет атрибут с таким же именем, старый атрибут будет переопределен новым значением.

Рассмотрим пример.

<���а href="http://www.aaa.com">

http://www.bbb.com

Поскольку атрибут может содержать только текст, результатом выполнения содержимого xsl:attributeтоже должны быть только текстовые узлы. Процессор в лучшем случае проигнорирует нетекстовые узлы, в худшем выведет сообщение об ошибке, прервав дальнейшую обработку, так что следует очень внимательно относиться к содержимому xsl:attribute.

Текстовое значение атрибута может задаваться не только символьными данными, Оно может генерироваться также элементами XSLT, такими, как, например, xsl:textи xsl:value-of. То есть вполне корректным будет следующее определение:

http://

.com

В том случае, если текстовое значение атрибута содержит символы перевода строки, при генерации атрибута они будут заменены сущностями, то есть определение

а¶

b

создаст атрибут с именем " href" и значением " a b":

<���а href="a b"/>

Техническая рекомендация объясняет такую ситуацию следующим образом: в соответствии со стандартом языка XML, символы перевода строки должны нормализоваться в значениях атрибутов пробелами, сущности же нормализовать не нужно. Но если бы символ перевода строки нормализовался в XSLT при выводе пробелом, то определения

a□b

и

a¶

b

были бы эквивалентны, что не отражает реального положения вещей. Для того чтобы исправить эту несуразицу, символ перевода строки при выводе в атрибуте нормализуется в XSLT символьной сущностью ( или ).

Подводя итог, перечислим в краткой форме основные особенности обращения с xsl:attribute.

□ Атрибуты могут создаваться только в узлах элементов . Если атрибут создается в узле, который не является узлом элемента, процессор может либо выдать ошибку, либо проигнорировать создаваемый атрибут.

□ Атрибуты могут содержать только текстовые узлы . Процессор может либо выдать ошибку, либо проигнорировать нетекстовые узлы.

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

□ В случае, когда документ преобразуется в другой XML-документ, символы перевода строки в элементе заменяются символьными сущностями.

Синтаксис элемента определяется следующей конструкцией:

name=" имя "

use-attribute-sets=" имена ">

Для того чтобы упростить создание в элементах целых наборов атрибутов, можно заранее определить их в элементе xsl:attribute-set. Обязательный атрибут nameзадает имя набора атрибутов. Элемент xsl:attribute-setсодержит последовательность, состоящую из нуля или более элементов xsl:attribute.

Именованные наборы атрибутов можно использовать, указывая их имена в значении атрибута use-attribute-sets, который может присутствовать в элементах xsl:element, xsl:copyи xsl:attribute-set, а также в литеральных результирующих элементах. В атрибуте use-attribute-setsчерез пробел перечисляются имена наборов атрибутов, которые должны быть использованы в данном элементе.

Включение набора атрибутов в элемент равносильно простому копированию элементов xsl:attribute, определенных в соответствующих элементах xsl:attribute-set.

Предположим, что во входящем документе нам нужно вывести структуру, состоящую из элементов с именем element, атрибут nameкоторых равен имени, атрибут attr-count — количеству атрибутов, а атрибут node-count— количеству дочерних узлов соответствующего элемента.

version="1.0"

xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

use-attribute-sets="elements attrs">

В этом преобразовании определение элемента

use-attribute-sets="elements attrs">

равносильно определению

Как уже было сказано, элемент xsl:attribute-setможет также использовать другие наборы атрибутов при помощи use-attribute-sets. Например, в предыдущем преобразовании набор атрибутов elementsмог быть определен как:

use-attribute-sets="attrs">

Тогда для достижения того же результата элемент с именем elementмог быть создан с использованием только одного набора атрибутов:

use-attribute-sets="elements">

Именованный набор атрибутов не может прямо или косвенно (посредством других наборов атрибутов) использовать в значении use-attribute-setsсебя самого. Такая ситуация породила бы бесконечный цикл. Вообще, не рекомендуется выстраивать сложную иерархию именованных наборов атрибутов, поскольку это может сильно усложнить обработку и снизить эффективность преобразования, хотя, естественно, все зависит от конкретного случая.

Мы упомянули о том, что именованные наборы атрибутов используются в элементах посредством атрибута xsl:use-attribute-sets. Разберем более детально, где этот атрибут может применяться, и какие функции он при этом выполняет. Для удобства эти данные сведены в табл. 7.1.

Таблица 7.1. Использование атрибута xsl:use-attribute-sets