Include (SP-Tag)

Name

<sp:include> - Includiert ein anderes Template

Syntax

<sp:include anchor="anchor.example"/>

Beschreibung

Mit dem Include Tag ist es möglich innerhalb eines Templates andere bereits erstellte Templates oder SPML-Seiten von Webapplikationen einzubinden. Es kann über das template-Attribut entweder der Anchor oder eine Variable mit einer Template-ID angegeben werden. Zu includende SPML-Seiten werdne über das uri-Attribut angegeben. sp:include wird durch die Ausgabe des eingebundenen Templates oder der SPML-Seite ersetzt.

Attribute

Name	Type	Required	Default	ab IES Version
`template`	Variable	Ja oder anchor oder uri	None	1
`anchor`	Anchor	Ja oder template oder uri	None	1
`uri`	Text	Ja oder template oder anchor	None	1
`context`	Text	Nein	None	1
`module`	Text	Nein	None	1
`mode`	Text	Nein	None	1

template: Zu includendes Template (Variable mit einer Template-ID).

anchor: Anchor-Name des zu includenden Templates.

uri: URI einer Seite die includiert werden soll. Dieser muß in der gleichen Webapplikation liegen. Weiter kann mit dem context-Attribute oder dem module-Attribute eine andere Webapplikation angegeben werden, dessen Seite includiert werden soll.

context: SPML-Seiten sind immer Teil einer Webapplikation. Die mit dem Attribut uri angegebenen SPML-Seite bezieht sich immer auf die aktuelle Webapplikation. Soll eine Seite einer anderen Webapplikation eingebunden werden, so wird mit diesem Attribut der Context der Webapplikation angegeben. Da sich der Context einer Webapplikation ändern kann ist in den meisten Fällen die Verwendung des Attributes module zu empfehlen, da hier die ID der Webapplikation angegeben wird.

module: SPML-Seiten sind immer Teil einer Webapplikation. Die mit dem Attribut uri angegebenen SPML-Seite bezieht sich immer auf die aktuelle Webapplikation. Soll eine Seite einer anderen Webapplikation eingebunden werden, so wird mit diesem Attribut die ID der Webapplikation angegeben. Dieses Attribut ist dem Attribut context vorzuziehen, da sich der Context einer Webapplikation ändern kann.

mode

Mit diesem Attribut kann angegeben werden, in welchem Modus die includete SPML-Seite oder das includete Template ausgeführt werden soll.

in: Führt das Template oder die SPML-Seite im In-Modus aus.
out: Führt das Template oder die SPML-Seite im Out-Modus aus.

Beispiele

Einfügen von Templates

Template Quelltext

<html>
   <head>
      <title>Template Include</title>
   </head>
   <body>
      <sp:include anchor="html.header"/>
      <sp:include template="currentTemplate"/>
      <sp:include anchor="html.footer"/>
   </body>
</html>