Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen der Seite angezeigt.

--- typo3:about:functions:if [2014/03/12 21:06] – angelegt admin
+++ typo3:about:functions:if [2015/12/03 19:32] (aktuell) – Externe Bearbeitung 127.0.0.1
@@ Zeile 1: / Zeile 1: @@
 ====== if ======
-Mit ''if'' ist es möglich, eine oder mehrere Bedingungen zu definieren, bevor das Ergebnis eines cObjects ausgegeben wird. Bei Erfüllung aller Kriterien wird //true// zurückgegeben. Wenn nur eine Bedingung nicht erfüllt wird, führt dies mit der Meldung //false// zum Abbruch.
+Mit ''if'' ist es möglich, eine oder mehrere Bedingungen zu definieren, bevor das Ergebnis eines cObjects ausgegeben wird. Bei Erfüllung __aller__ Kriterien wird //true// zurückgegeben. Wenn nur eine Bedingung nicht erfüllt wird, führt dies mit der Meldung //false// zum Abbruch.
 ===== Eigenschaften =====
 ^Eigenschaft^Datentyp^Beschreibung^
-^isNull|stdWrap| |
+^isNull|stdWrap|Bedingung ist erfüllt, wenn der abgefragte Wert der PHP-Wert //NULL// ist. Da dieser Wert nicht in TypoScript gesetzt werden kann (//NULL// würde als String angesehen), sind nur die stdWrap-Funktionen verfügbar. <code typoscript>
-^isTrue|string /stdWrap| |
+= TEXT
-^isFalse|string /stdWrap| |
+.value = Das Feld 'media' ist leer.
-^isPositive|integer / stdWrap +calc| |
+.if.isNull.data = field:media
-^isGreaterThan|value / stdWrap| |
+</code>|
-^isLessThan|value / stdWrap| |
+^isTrue|string /stdWrap|Bedingung ist erfüllt, wenn der abgefragte Wert nicht leer oder ''0'' ist. <code typoscript>
-^equals|value / stdWrap| |
+= TEXT
-^isInList|value / stdWrap| |
+.value = Es existiert eine Datei im Feld 'media'.
-^value|value / stdWrap| |
+.if.isTrue.data = field:media
-^negate|boolean| |
+</code>|
-^directReturn|boolean| |
+^isFalse|string /stdWrap|Bedingung ist erfüllt, wenn der abgefragte Wert leer oder ''0'' ist. <code typoscript>
+= TEXT
+.value = Das Feld 'media' ist leer.
+.if.isFalse.data = field:media
+</code>|
+^isPositive|integer / stdWrap +calc|Bedingung ist erfüllt, wenn der abgefragte Wert eine Zahl ≥ 1 ist.<code typoscript>
+= TEXT
+.value = Der Wert ist positiv.
+.if.isPositive = -5 + 6
+</code> |
+^isGreaterThan|value / stdWrap|Bedingung ist erfüllt, wenn der abgefragte Wert höher ist als der Wert unter ''if.value''. <code typoscript>
+= TEXT
+.value = Die Seiten-ID ist größer als 4.
+.if.isGreaterThan.data = GP:id
+.if.value = 4
+</code>|
+^isLessThan|value / stdWrap|Bedingung ist erfüllt, wenn der abgefragte Wert niedriger ist als der Wert unter ''if.value''. <code typoscript>
+= TEXT
+.value = Die Seiten-ID ist kleiner als 4.
+.if.isLessThan.data = GP:id
+.if.value = 4
+</code>|
+^equals|value / stdWrap|Bedingung ist erfüllt, wenn der abgefragte Wert mit dem Wert unter ''if.value'' übereinstimmt. <code typoscript>
+= TEXT
+.value = Die aktuelle Seite heißt 'Impressum'.
+.if.equals.field = title
+.if.value = Impressum
+</code>|
+^isInList|value / stdWrap|Bedingung ist erfüllt, wenn der abgefragte Wert in der kommaseparierten Liste unter ''if.value'' enthalten ist. <code typoscript>
+= TEXT
+.value = Der Untertitel lautet 'Hund', 'Katze' oder 'Maus'.
+.if.isInList.data = field:subtitle
+.if.value = Hund,Katze,Maus
+</code>|
+^value|value / stdWrap|Der hier angegebene Wert dient zum Vergleich mit den Daten, die mit ''isGreaterThan'', ''isLessThan'', ''equals'' oder ''isInList'' abgefragt wurden.|
+^negate|boolean|Wenn aktiviert, wird das Ergebnis der Abfrage ins Gegenteil verkehrt.\\ __**if.negate = 1** bewirkt:__\\ ''if.isTrue'' -> false\\ ''if.isFalse'' -> true\\ ''if.isPositive'' -> ''0'' oder negativ\\ ''if.isGreaterThan'' -> kleiner oder gleich\\ ''if.isLessThan'' -> größer oder gleich\\ ''if.equals'' -> ungleich\\ ''if.isInList'' -> nicht enthalten\\ Bei mehreren Bedingungen gilt das Gesamtergebnis dieser Abfragen, also //true// oder //false//.|
+^directReturn|boolean|Ist diese Eigenschaft vorhanden (egal welcher Wert), haben alle anderen Eigenschaften von ''if'' keine Wirksamkeit! Die Ausgabe wird nur noch durch den folgenden Wert bestimmt.\\ Mit dieser Eigenschaft kann man zum einen die Ausgabe simulieren; zum anderen könnte der Wert mithilfe einer Konstante gesetzt werden.|
+===== Beispiele =====
+==== Verknüpfung mehrerer Bedingungen ====
+Der Wert //true// wird zurückgegeben, wenn alle Bedingungen erfüllt sind. Die Eigenschaft ''if.value'' kann nur einmal definiert werden und gilt somit für alle vergleichenden if-Eigenschaften.
+<code typoscript>
+= TEXT
+{
+  value = Ausgabetext
+  if.isPositive = 1+3
+  if.equals = foo
+  if.value = foo
+}
+# Beide Vergleiche beziehen sich auf 'if.value':
+= TEXT
+{
+  value = Ausgabetext
+  if.isGreaterThan = 5
+  if.equals = 2
+  if.value = 2
+}
+</code>
+==== Verknüpfung mehrerer Bedingungen und Umkehrung ====
+Bei der Anwendung von ''negate'' mit mehreren Abfragen ist zu beachten, dass sich die Umkehrung auf das __Gesamtergebnis__ der Bedingungen bezieht.
+<code typoscript>
+= TEXT
+{
+  value = Ausgabetext
+  if.isPositive = 1
+  if.equals = foo
+  if.value = bar
+  if.negate = 1
+}
+</code>

Snippets + Wiki

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Unterschiede

Seiten-Werkzeuge