Bedingte Auszeichnung

Anwendung der (:if:) Direktive

Die (:if:) Direktive erlaubt es, Teile einer Seite bei der Darstellung zu berücksichtigen oder auszuschließen. Der grundsätzliche Aufbau der (:if:) Direktive ist

wobei "Bedingung" eine der unten genannten zu testenden Bedingungen bedeutet und "Parameter" einen Wert oder ein anderes Argument der Bedingung beschreibt.

Beachten Sie, dass (:if:) ohne Parameter und (:ifend:) identisch sind. Beachten Sie auch, dass automatisch eine vorhergehende Bedingung beendet. Wegen verschachtelter Bedingungen siehe verschachtelte Bedingungen.

Die folgenden Bedingungen sind eingebaut:

Die "name" und "group" Bedingungen arbeiten sogar in einer inkludierten Seite, da die "name" and "group" immer die aktuell ausgegebene Seite überprüfen, und nicht die Seite in der die Auszeichnung enthalten ist (Quelltext).

Beachte: Es gibt keine eingebaute Bedingung, die ?action= testet. Um zu prüfen, welche Aktion aktuell angefordert wurde, benutze (:if equal {$Action} ACTION:).

Negierte Bedingungen

Negierte Formen der Bedingungen funktionieren ebenfalls:

Verschachtelte Bedingungen

Beachten Sie, dass jedes (:if:) automatisch das vorhergehende beendet, daher können Auszeichnungen einfach durchgeprüft werden (und sind nicht verschachtelt).

 Die folgenden beiden Beispiele sind identisch in ihrer Wirkung:

• (:if cond1:) cond1 is true (:if cond2:) cond2 is true (:ifend:)
• (:if cond1:) cond1 is true (:ifend:)(:if cond2:) cond2 is true (:ifend:)

Bedingungen können seit der Version 2.2.beta66 verschachtelt werden. Für verschachtelte Bedingung müssen Sie die if und die korrespondierenden else/ifend nummerieren.

(:if cond1:)
   cond1 is true
      (:if2 cond2:)
         cond1 und cond2 sind wahr
      (:else2:)
         cond1 ist wahr, cond2 ist falsch
      (:if2end:)
(:else:)
   cond1 ist falsch, Test auf cond2 wurde ignoriert
(:ifend:)

Für eine bessere Lesbarkeit wurden Einrückungen vorgenommen.

Nutzung von Platzhaltern (Wildcard)

Das Zeichen * kann als Platzhalter (Wildcard) genutzt werden, um jedes beliebige Zeichen, keinmal, einmal or mehrfach zu repräsentieren.
Das Zeichen ? kann als Platzhalter (Wildcard) genutzt werden, um ein beliebiges Zeichen exakt einmal zu repräsentieren.
Die Platzhalter Zeichen (* und ?) können auch mit den name und group Bedingungen benutzt werden:

Anwendung mit PageList-Vorlagen

Die bedingte Auszeichnung ((if:):-Direktive) wird extensiv mit PageList-Vorlagen genutzt.

Anwendung mit Seiten Variablen:

Bedingungen zur Strukturierung von pagelist Ausgaben:

   (:if equal {<$Group}:)               Am Anfang der Liste
   (:if equal {>$Group}:)               Am Ende der Liste
   (:if ! equal {=$Group} {<$Group}:)   Erstes Element der Gruppe
   (:if ! equal {=$Group} {>$Group}:)   Letztes Element der Gruppe

Gebrauch von Seiten-Text-Variablen, Seitenspezifische Variablen und Formatierungsanweisungen im Ausdruck

Page-Text-Variablen (PTVs), Page-Variablen (PVs) und Markup-Expressions können in Bedingungen verwendet werden. Sie werden zugewiesen und ausgewertet, bevor die Bedingungen ausgewertet werden.

Kombinieren von Bedingungen

Bedingungen (wie vorher definiert) können zu komplexeren bedingten Ausdrücken kombiniert werden, in dem eine der drei folgenden untereinander äquivalenten Formen benutzt werden:

(:if expr EXPRESSION :)
(:if [ EXPRESSION ] :)
(:if ( EXPRESSION ) :)

Bedingungen werden mit Booleschen Operatoren und Klammern zu Ausdrücken verbunden. In der folgenden Tabelle sind A und B entweder reguläre Bedingungen oder geklammerte sub-Ausdrücke regulärer Bedingungen:

Beispiel

(:if [ name SomePage and group SomeGroup ]:)    entspricht (:if name SomeGroup.SomePage:)

Wichtige Hinweise:

• Leerzeichen um Operatoren und Klammern sind erforderlich.
• Bei unpaariger Klammersetzung gibt es keine spezifischen Fehlerhinweise.
• Bei verschachtelten Ausdrücken werden runde Klammer (keine eckigen) benutzt.

Das Folgende ist insofern ein möglicher Weg, eine Bedingung zu formulieren, durch die der folgende Inhalt nur angezeigt wird, wenn der Nutzer entweder Administrator ist oder wenn er eingeloggt ist und das angegebene Datum abgelaufen ist.

Das Verschachteln mit Hilfe eckiger Klammern funktioniert wie erwartet nicht:

Eine häufiger Anwendungsfall für komlexeren Tests sind Ausdrücke wie

wodurch ein Logout-Link genau dann angezeigt wird, wenn admin-, attr- oder edit-Rechte vorhanden sind.

Administratoren (Fortgeschrittene)

Neue Bedingungen kreieren

Siehe das Kochbuch-Rezept Cookbook:ConditionalMarkupSamples (nur auf Englisch verfügbar).

Siehe auch spezielle Verweise für die Benutzung von {*$Variablen}.

Übersetzung von PmWiki.ConditionalMarkup Originalseite auf PmWikiDe.ConditionalMarkup - Rückverweise
Zuletzt geändert:
PmWikiDe.ConditionalMarkup am 10.06.2012
PmWiki.ConditionalMarkup am 10.09.2011