Das sd:call-template- Element

Ermöglicht den Aufruf eines sd:template-Elements, das entweder lokal in der aktuellen Ausgabeseite oder in einer besonderen Ausgabeseite vom Typ 'Library' mit dem Wurzelelement sd:library definiert worden ist. Ein sd:template-Element bündelt verschiedene Elemente unter einem gemeinsamen Namen und ermöglicht deren Mehrfachnutzung. Man denke bsp. an eine Situation, in welcher viele Ausgabeseiten mit denselben Button-Beschriftungen erstellt werden sollen. Anstatt die Button-Beschriftungen in jeder Ausgabeseite neu zu erstellen und sie nur aufwendig ändern zu können, kann eine Library-Seite mit einigen sd:template-Elementen entwickelt und von den verschiedenen Ausgabeseiten her aufgerufen werden.

Beachten Sie, daß dieses Element ausdrücklich keine Parameterübergabe erfordert. Der aktuelle Kontext wird automatisch mit weitergegeben, auch wenn es sich um eine externe Bibliothek handelt.

Typ

Hauptelement, ergänzendes Element

Äußere Elemente

Attribute

sd:library-name *: Legt den Namen der sd:library (= sd:Bibliothek) fest. Falls die Vorlage in der aktuellen Ausgabeseite definiert ist, muß dieses Attribut einen Punkt ('.') als Wert erhalten. Ist die Vorlage in einer Ausgabeseite vom Typ 'Library' definiert, so ist der vollständige Name der Datei einzusetzen.
sd:template-name *: Legt den Namen des aufzurufenden template (= Vorlage) fest
sd:name: Legt den Namen des Objektes fest. Dieses Attribut ist immer ein Pflicht-Attribut.

Keine Child- oder inneren Elemente zulässig

Beispiele

Wenn eine Library (= Ausgabeseite vom Typ Library) mit dem Dateinamen 'lib.html' definiert wurde und diese ein sd:template-Element namens 'myName' enthält, dann wird mit dem folgenden Code der Inhalt dieses Elements an der aktuellen Position eingefügt:

<sd:call-template sd:name="myCaller"
	sd:library-name="lib.html" sd:template-name="myName" />

Bemerkungen

Das sd:call-template - Element benötigt aus internen Gründen einen eigenen Namen, der eindeutig sein muß.