<xsl:attribute-set> XSLT

Become a Patron!

Элемент xsl:attribute-set определяет именованный набор атрибутов.

Элементы-родители:

Элементы-потомки:

Синтаксис

XSLT 1.0 и 2.0

<xsl:attribute-set
    name = "имя"
    use-attribute-sets = "имена">
    <!-- Содержимое: xsl:attribute* -->
</xsl:attribute-set>

Атрибуты

  • name — обязательный атрибут, задает имя набора атрибутов.
  • use-attribute-sets — необязательный атрибут, задает перечень названий наборов атрибутов через пробел.

Спецификация

XSLT 3.0

<xsl:attribute-set
    name = "eqname"
    use-attribute-sets = "eqnames"
    visibility = "public | private | final | abstract"
    streamable = "boolean" >
    <!-- Содержимое: xsl:attribute* -->
</xsl:attribute-set>

Атрибуты

  • name — обязательный атрибут
  • use-attribute-sets — необязательный атрибут
  • visibility — необязательный атрибут
  • streamable — необязательный атрибут

Описание и примеры

Для того чтобы упростить создание в элементах целых наборов атрибутов, можно заранее определить их в элементе 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.

Пример 1

В следующем примере сперва создается именованный набор атрибутов title-style, а затем используется в правиле шаблона.

<xsl:attribute-set name="title-style">
    <xsl:attribute name="font-size">12pt</xsl:attribute>
    <xsl:attribute name="font-weight">bold</xsl:attribute>
</xsl:attribute-set>

<xsl:template match="chapter">
    <p quadding="start" xsl:use-attribute-sets="title-style"> 
        <xsl:value-of select="self::node()"/>
    </p>
</xsl:template>

Пример 2

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

Входной документ:

<a b="1" c="2">
    <d e="3" f="4" g="5" />
</a>

Преобразование:

<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
    <xsl:output indent="yes" />

    <xsl:attribute-set name="attrs">
        <xsl:attribute name="attr-count">
            <xsl:value-of select="count(@*)" />
        </xsl:attribute>
    </xsl:attribute-set>

    <xsl:attribute-set name="elements">
        <xsl:attribute name="name">
            <xsl:value-of select="name()" />
        </xsl:attribute>
        <xsl:attribute name="node-count">
            <xsl:value-of select="count(*)" />
        </xsl:attribute>
    </xsl:attribute-set>

    <xsl:template match="*">
        <xsl:element name="element" use-attribute-sets="elements attrs">
            <xsl:apply-templates select="*" />
        </xsl:element>
    </xsl:template>

</xsl:stylesheet>

Выходной документ:

<?xml version="1.0" encoding="utf-8"?>
    <element name="a" node-count="1" attr-count="2">
        <element name="d" node-count="0" attr-count="3"/>
    </element>

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

<xsl:element name="element" use-attribute-sets="elements attrs">
    <xsl:apply-templates select="*"/>
</xsl:element>

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

<xsl:element name="element">
    <xsl:attribute name="name">
        <xsl:value-of select="name()"/>
    </xsl:attribute>
    <xsl:attribute name="node-count">
        <xsl:value-of select="count(*)"/>
    </xsl:attribute>
    <xsl:attribute name="attr-count">
        <xsl:value-of select="count(@*)"/>
    </xsl:attribute>
    <xsl:apply-templates select="*"/>
</xsl:element>

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

<xsl:attribute-set name="elements" use-attribute-sets="attrs">
    <xsl:attribute name="name">
        <xsl:value-of select="name()" />
    </xsl:attribute>
    <xsl:attribute name="node-count">
        <xsl:value-of select="count(*)" />
    </xsl:attribute>
</xsl:attribute-set>

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

<xsl:element name="element" use-attribute-sets="elements">
    <xsl:apply-templates select="*" />
</xsl:element>

См. также

  • xsl:attribute — служит для создания узлов атрибутов.

Ссылки

MDN xsl:attribute-set на MDN
MSDN xsl:attribute-set на MSDN