Set (SP-Tag)

Aus SiteparkWiki
Zur Navigation springen Zur Suche springen

Name

<sp:set> - Setzt Variablen

Syntax

<sp:set name="variable" value="Her name is ${name}"/>

Beschreibung

Mit dem Set-Tag können eigene Variablen innerhalb eines Templates definiert werden. Mit Hilfe des Attributes scope kann der Gültigkeitsbereich der Variable bestimmt werden. Mit sp:set können Zeichenketten, Expressions oder Objekte (als Attribut angegeben) für eine Variable gesetzt werden. Bei overwrite gleich false, wird die Variable nur gesetzt wenn sie noch nicht existiert oder leer ist.

Attribute

Name Type Required Default ab IES Version
name Variable Ja None 1
value Text Ja, oder expression bzw.object oder sp:set als BodyTag (siehe Beispiel) None 1
expression Expression Ja oder value bzw object None 1
object Attribute Ja oder value bzw. expression None 1
default Text Nein, None 2.0.2
overwrite Condition Nein None 1
locale Locale Nein None 1
scope Scope Nein request 1
name
Name der neuen Variable.
value
Zu setzender Wert. Dieser wird immer als Zeichenkette ausgewertet.
expression
Die Expression wird ausgewertet und als Wert in die Variable geschrieben.
object
Evaluiert das Attribut und sie in name. Im Gegensatz zu value wird hier das Object gespeichert und nicht der Text.
default
Der Text, der verwendet wird, wenn der Inhalt von value und body leer sind.
overwrite
Bestimmt, ob eine evtl. vorhandene Variable überschrieben werden soll. true bzw. false.
locale
Dieses Attribut dient zur Auswahl der zu verwendende Sprache bei mehrsprachiger Variablen.
scope
Gültigketisbereich, in dem die Variable definiert ist. Möglich sind page und request.

Beispiele

Variablen setzten

Template Quelltext

<sp:set name="a" value="10"/>
<sp:set name="b" value="20"/>

<sp:set name="c" expression="${a} + ${b}"/>

<sp:set name="abc" value="a + b = ${c}"/>

<sp:set name="output">Die Aufgabe mit Ergebnis: <sp:print name="abc"/></sp:set>

<sp:print name="output"/>

Ausgabe

Die Aufgabe mit Ergebnis: a + b = 30