<xsl:element>-Element

  • Artikel

Erstellt ein Ausgabeelement mit dem angegebenen Namen.

<xsl:element
  name = "element-name"  
  namespace = "uri-reference"
  use-attribute-sets = QName
</xsl:element>

Attribute

  • Name
    Erforderlich. Der Name des zu erstellenden Elements. Wenn dieser Wert ein Qualifizierte Namen (XSLT) ist, wird der Elementknoten in dem Namespace erstellt, der derzeit an das Präfix gebunden ist, sofern er nicht von einem namespace-Attribut überschrieben wurde. Der Wert des name-Attributs wird als eine Attributwertvorlage interpretiert, d. h., Ausdrücke in geschweiften Klammern werden ausgewertet und wie in <xsl:value-of> in Zeichenfolgen konvertiert. Auf diese Weise kann der Name des Elements errechnet oder aus dem XML-Quelldokument abgerufen werden.

  • namespace
    Der Namespace-URI des erstellten Elements. Wenn das name-Attribut einen QName enthält, wird das darin angegebene Präfix an den im namespace-Attribut angegebenen Namespace gebunden. Dies erfordert bei der Serialisierung möglicherweise zusätzliche Namespacedeklarationen. Der namespace-Wert wird als eine Attributwertvorlage interpretiert.

  • use-attribute-sets
    Eine durch Leerraum getrennte Liste von Attributgruppen, die als Qualifizierte Namen (XSLT) angegeben sind. Durch Angeben dieses Attributs wird jedes Attribut in jeder aufgelisteten Attributgruppe deklariert.

Elementinformationen

Anzahl der Vorkommen

Unbegrenzt

Übergeordnete Elemente

xsl:copy, xsl:element, xsl:fallback, xsl:for-each, xsl:if, xsl:message, xsl:otherwise, xsl:param, xsl:template, xsl:variable, xsl:when, xsl:with-param, Ausgabeelemente

Untergeordnete Elemente

xsl:apply-templates, xsl:attribute, xsl:call-template, xsl:choose, xsl:comment, xsl:copy, xsl:copy-of, xsl:element, xsl:for-each, xsl:if, xsl:processing-instruction, xsl:text, xsl:value-of, xsl:variable, Ausgabeelemente

Hinweise

Mithilfe des <xsl:element>-Elements kann ein Element mit einem ermittelten Namen erstellt werden. Der Name des zu erstellenden Elements wird durch ein erforderliches name-Attribut und ein optionales namespace-Attribut angegeben. Der Inhalt des <xsl:element>-Elements stellt eine Vorlage für die Attribute und untergeordneten Elemente des erstellten Elements dar.

Das Element stellt ein Escapeverfahren zum Erstellen von Elementen mit demselben Namespace bereit, z. B. XSLT selbst.

Beispiel

Das <xsl:element>-Element ist erforderlich, da XSLT-Elemente nicht als Ausgabeelemente verwendet werden können. In diesem Beispiel wird veranschaulicht, wie ein <xsl:template>-Element ausgegeben wird.

XML-Datei (item.xml)

<?xml version="1.0"?>
<?xml-stylesheet type="text/xsl" href="element.xsl" ?>
<root>
   <item>My Item</item>
</root>

XSLT-Datei (element.xsl)

<?xml version="1.0"?>
<xsl:stylesheet version="1.0"
      xmlns:xsl="http://www.w3.org/1999/XSL/Transform" >

<xsl:template match="item">
   <xsl:element name="xsl:template">
      <xsl:attribute name="match">cost</xsl:attribute>
      <xsl:attribute name="xml:space">preserve</xsl:attribute>
      <xsl:apply-templates/>
   </xsl:element>
</xsl:template>

</xsl:stylesheet>

Ausgabe

Dies ist die formatierte Ausgabe:

My Item

Im Folgenden wird die Prozessorausgabe dargestellt, wobei aus Gründen der Übersichtlichkeit Zeilenumbrüche hinzugefügt wurden.

<?xml version="1.0"?>
<xsl:template match="cost" 
      xml:space="preserve" 
      xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
My Item</xsl:template>