Condition (SP-Tag)

Aus SiteparkWiki
Zur Navigation springen Zur Suche springen

Name

<sp:condition>, <sp:if>, <sp:elseif>, <sp:else> - Bedingungen prüfen

Syntax

<sp:if condition="${a} > ${b}">
  ...
</sp:if>

<sp:condition>
  <sp:if condition="${a} <= 0">
    ...
  </sp:if>
  <sp:elseif condition="${a} > 0 && ${a} < 10">
    ...
  </sp:elseif>
  <sp:elseif condition="${a} >= 10 && ${a} < 100">
    ...
  </sp:elseif>
  <sp:else>
    ...
  </sp:else>
</sp:condition>

Beschreibung

Die vier Tags ermöglichen es verschiedene Bedingungen abzufragen. Einfache Abfragen können direkt mit dem <sp:if> erstellt werden.

Es bestehen zwei Möglichkeiten der if-Abfrage. Zum einen kann mit dem name-Attribute die zu prüfende Variable und mit gt, gte, lt, usw. die zu prüfende Bedingung angegeben werden. Für komplexe Abfragen ist diese Möglichkeit nicht ausreichend, da verschachtelte UND- und ODER-Verknüpfungen so sehr Aufwendig werden können. Das condition-Attribute bietet eine weitere Möglichkeit Bedingungen zu formulieren. Innerhalb dieses Attributes können Ausdrücke wie folgt angegeben werden.

<sp:if condition="(${a} > ${b}) && ((${a} + 3) / 10 < ${b})}">
  ..
</sp:if>

Sollte der Vergleich positiv sein, wird der Tagbody des if-Tags weiter behandelt. Andernfalls wird der Taginhalt übersprungen. Bei aufwendigeren Abfragen, die zum Beispiel einen else Tag oder mehrere elseif Bereiche besitzen können, wird das Tag <sp:condition> benötigt, dass die Abfrage umschliesst. Das condition-Tag ermöglicht die Implementation von diversen <sp:if>-<sp:elseif>-<sp:else> Konstrukten. Zu beachten ist, dass zwischen <sp:condition> und <sp:if> kein Text stehen darf. Das gleiche gilt für </sp:if> und <sp:elseif>, </sp:elseif> und <sp:elseif>, </sp:elseif> und <sp:else> sowie </sp:else> und </sp:condition>.

Attribute

Name Type Required Default ab IES Version
name Variable Ja oder condition None 1
locale Locale Nein None 1
isNull Condition Nein None 1
ic Condition Nein false 1
contains Text Nein None 1
match Regular-Expression Nein None 1
eq Attribute Nein None 1
neq Attribute Nein None 1
gt Attribute Nein None 1
gte Attribute Nein None 1
lt Attribute Nein None 1
lte Locale Nein None 1
condition Condition Nein None 1
name
Variablenname eines Objektes das verglichen werden soll.
locale
Dieses Attribut dient zur Auswahl der zu verwendende Sprache bei mehrsprachiger Variablen.
isNull
Die Bedingung ist erfüllt, wenn die Variable in name leer oder nicht vorhanden ist und isNull den Wert true hat. Wenn isNull den Wert false hat, ist die Bedingungen erfüllt, wenn die die Variable in name nicht leer ist.
ic
Die Auswertung soll "ignore case" durchgeführt werden. Bezieht sich auf eq, neq, gt, gte, lt, lte, und contains.
contains
Zeichenkette, die in der Variablen enthalten sein soll.
match
Regulärer Ausdruck, der in der Variablen enthalten sein soll.
eq
Die Bedingung ist erfüllt, wenn die Variable in name gleich der Variable in eq ist.
neq
Die Bedingung ist erfüllt, wenn die Variable in name ungleich der Variable in neq ist.
gt
Die Bedingung ist erfüllt, wenn die Variable in name grösser als der Variable in gt ist.
gte
Die Bedingung ist erfüllt, wenn die Variable in name grösser oder gleich der Variable in gte ist.
lt
Die Bedingung ist erfüllt, wenn die Variable in name kleiner als in der Variable in lte ist.
lte
Die Bedingung ist erfüllt, wenn die Variable in name kleiner oder gleich der Variable in lte ist.
condition
Es wird eine Condition erwartet, die den Wert true oder false zurückliefert.

Beispiele

isNull Prüfung

Template Quelltext

<sp:set name="foo" value="bar"/>
<sp:if name="foo">	foo ist definiert!
</sp:if>

<%-- kein Inhalt ist gleichbedeutend mit 'nicht definiert' --%>

<sp:set name="foo" value=""/>

<sp:if name="foo" isNull="true">
  foo ist nicht definiert!
</sp:if>

Ausgabe

foo ist definiert!
foo ist nicht definiert!

Einfache if Bedingung

Template Quelltext

<sp:set name="foo" value="bar"/>
<sp:if name="foo" eq="bar">
  foo hat den Wert <sp:print name="foo"/>
</sp:if>

Ausgabe

foo hat den Wert bar

Einfache if-elseif-else Bedingung

Template Quelltext

<%--
  Bei der Verwendung von if-elseif-else Konstrukten müssen die
  einzelnen Tags in einem <sp:condition> zusammengefasst werden.
--%>
<sp:condition>
  <sp:if name="foo" eq="foo">
    Ich bin im if-Zweig
  </sp:if>
  <sp:elseif name="foo" eq="barx">
    Ich bin im ersten ifelse-Zweig
  </sp:elseif>
  <sp:elseif name="foo" eq="bar">
    Ich bin im zweiten elseif-Zweig
  </sp:elseif>
  <sp:elseif condition="!isNull(${foo})">
    Ich bin im dritten elseif-Zweig
  </sp:elseif>
  <sp:else>
    Ich bin im else-Zweig
  </sp:else>
</sp:condition>

Ausgabe

Ich bin im zweiten elseif-Zweig

Abfrage mit condition

Template Quelltext

<sp:if condition="${foo} == 'bar'">
  ${foo} == 'bar' liefert true
</sp:if>

<sp:set name="x" value="5"/>
<sp:set name="y" value="10"/>

<sp:if condition="(${x} + ${y}) == 15">
  Die Summe von x und y ist 15
</sp:if>

<sp:if condition="${x} > 2 && ${x} < 20">
  x ist größer als 2 und kleiner als 20
</sp:if>

Ausgabe

${foo} == 'bar' liefert true
Die Summe von x und y ist 15
x ist größer als 2 und kleiner als 20

Prüfe Boolean

Template Quelltext

<sp:set name="boolean" value="true"/>
<sp:if condition="${boolean} == true">
  1: boolean ist wahr.
</sp:if>
<sp:if condition="${boolean} == 'true'">
  2: boolean ist wahr.
</sp:if>
<sp:if condition="${boolean} == 1">
  3: boolean ist wahr.
</sp:if>

Ausgabe

2: boolean ist wahr.