Set (SP-Tag): Unterschied zwischen den Versionen
Zur Navigation springen
Zur Suche springen
| Zeile 13: | Zeile 13: | ||
{| class="prettytable sortable" | {| class="prettytable sortable" | ||
|- class="hintergrundfarbe1" | |- class="hintergrundfarbe1" | ||
| − | ! Name | + | ! Name || Type || Required || Default |
|- | |- | ||
| − | | <code>name</code> | + | | <code>name</code> |
| + | | [[Variablename]] | ||
| + | | Ja | ||
| + | | None | ||
|- | |- | ||
| − | | <code>value</code> | + | | <code>value</code> |
| + | | [[String]] | ||
| + | | Ja, oder expression bzw.object oder sp:set als BodyTag (siehe Beispiel) | ||
| + | | None | ||
|- | |- | ||
| − | | <code>expression</code> | + | | <code>expression</code> |
| + | | [[Expression]] | ||
| + | | Ja oder value bzw object | ||
| + | | None | ||
|- | |- | ||
| − | | <code>object</code> | + | | <code>object</code> |
| + | | [[Objekt]] | ||
| + | | Ja oder value bzw. expression | ||
| + | | None | ||
|- | |- | ||
| − | | <code>overwrite</code> | + | | <code>overwrite</code> |
| + | | [[Boolean]] | ||
| + | | Nein | ||
| + | | None | ||
|- | |- | ||
| − | | <code>locale</code> | + | | <code>locale</code> |
| + | | [[Locale]] | ||
| + | | Nein | ||
| + | | None | ||
|- | |- | ||
| − | | <code>scope</code> | + | | <code>scope</code> |
| + | | [[Scope]] | ||
| + | | Nein | ||
| + | | request | ||
|} | |} | ||
| − | ;<code> | + | ;<code>name</code> |
| − | : | + | :Name der neuen Variable. |
| − | ;<code> | + | |
| − | : | + | ;<code>value</code> |
| + | :Zu setzender Wert. Dieser wird immer als [[String||Zeichenkette]] ausgewertet. | ||
| + | |||
| + | ;<code>expression</code> | ||
| + | :Die [[Expression]] wird ausgewertet und als Wert in die Variable geschrieben. | ||
| + | |||
| + | ;<code>object</code> | ||
| + | :Evaluiert das Attribut und sie in name. Im Gegensatz zu value wird hier das Object gespeichert und nicht der String. | ||
| + | |||
| + | ;<code>overwrite</code> | ||
| + | :Bestimmt, ob eine evtl. vorhandene Variable überschrieben werden soll. true bzw. false. | ||
| + | |||
| + | ;<code>locale</code> | ||
| + | :Dieses Attribut dient zur Auswahl der zu verwendende Sprache bei mehrsprachiger Variablen. | ||
| + | |||
| + | ;<code>scope</code> | ||
| + | :Gültigketisbereich, in dem die Variable definiert ist. Möglich sind page und request. | ||
| + | |||
==Beispiele== | ==Beispiele== | ||
| − | ==== | + | ====Variablen setzten==== |
Template Quelltext | Template Quelltext | ||
<source lang="xml"> | <source lang="xml"> | ||
| − | + | <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"/> | |
| − | < | ||
| − | |||
</source> | </source> | ||
Ausgabe | Ausgabe | ||
<source lang="text"> | <source lang="text"> | ||
| − | + | Die Aufgabe mit Ergebnis: a + b = 30 | |
</source> | </source> | ||
| + | |||
<noinclude> | <noinclude> | ||
[[Category:SP-Tags]] | [[Category:SP-Tags]] | ||
</noinclude> | </noinclude> | ||
Version vom 5. Juni 2008, 09:54 Uhr
Name
<sp:set> - Setzt Variablen
Syntax
<sp:set name="variable" value="His 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 |
|---|---|---|---|
name
|
Variablename | Ja | None |
value
|
String | Ja, oder expression bzw.object oder sp:set als BodyTag (siehe Beispiel) | None |
expression
|
Expression | Ja oder value bzw object | None |
object
|
Objekt | Ja oder value bzw. expression | None |
overwrite
|
Boolean | Nein | None |
locale
|
Locale | Nein | None |
scope
|
Scope | Nein | request |
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 String.
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