<xsl:element>-Element

Artikel
04/19/2011

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 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 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)

XSLT-Datei (element.xsl)

Ausgabe

Dies ist die formatierte Ausgabe:

My Item

Im Folgenden ist 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>

Freigeben über