Mit current kann auf Inhalte zugegriffen werden, die zuvor von einer anderen stdWrap-Funktion dynamisch generiert wurden. Ein typisches Beispiel ist split. Der jeweils aktuelle Wert des Elternelements wird mit current an ein Element oder einen Parameter übergeben.
Beispiel:
Der Wert des cObject 10, eins,zwei, wird mit split zu zwei dynamischen Werten aufgeteilt. Diese werden nacheinander dem cObj 1 innerhalb von split übergeben. Für jeden Wert werden die Funktionen des cObjects einmal angewendet, im Beispiel der Wrap.
page = PAGE page { 10 = TEXT 10 { value = eins,zwei split { token = , cObjNum = 1 1.current = 1 1.wrap = <p>|</p> } } } # Ausgabe: <p>eins</p> <p>zwei</p>
Wer sich in diesem Beispiel mit 10.split.1.debugData = 1 den Inhalt aus $cObj→data als Tabelle ausgeben lässt, erhält zweimal exakt denselben Datensatz aus der Tabelle pages. Zusätzlich gibt es jedoch ein Feld currentValue_kidjls9dksoje, dass die unterschiedlichen Werte des cObjects 10 ausgibt: eins und zwei. Eben auf diese temporär verfügbaren Inhalte kann man mit current zugreifen.
Das Elternelement in diesem Beispiel ist nicht das cObject 10, sondern page! Das ist wichtig, wie in folgendem Beispiel klar wird:
10 = TEXT 10.current = 1 10.wrap = <p>|</p> 20 = TEXT 20 { value = Hund,Katze,Maus split { token = , cObjNum = 1|*|2|*|3 1.current = 1 1.wrap = <h1>|</h1> } } 30 = TEXT 30.current = 1 30.wrap = <p>|</p> 40 = TEXT 40.current = 1 40.wrap = <p>|</p> # Ausgabe: <p></p> <h1>Hund</h1> <p>Maus</p> <p>Maus</p>
Zwei Dinge fallen auf:
split verfügbar, sondern kann auch in allen folgenden cObjects abgerufen werden. Für das cObj 10 gilt dies nicht, da zum Zeitpunkt des Renderns noch kein current-Wert zur Verfügung stand.split steht immer der letzte (= der aktuelle, englisch: current) Wert zur Verfügung. Im Beispiel wird nur der erste Wert von split verarbeitet und ausgegeben (durch den Einsatz von optionSplit). Die beiden folgenden cObjects 30 und 40 sind keine Unterobjekte von split und erhalten über current daher jeweils den letzten Wert, der auf der Seite gespeichert ist.Überschreibt den aktuellen Wert des Elternelements mit dem vorher definierten Wert. Der neue Wert wird bei allen zugehörigen Elementen angewendet.
Im folgenden Beispiel wird der erste Wert eins im cObj 1.10 überschrieben, was sich auch auf 1.20 auswirkt. Das liegt daran, dass beides Unterelemente vom cObj 1 sind. Der Wert im cObj 2 bleibt davon ausgenommen, current lädt hier den Wert, den split diesem cObject zugeordnet hat.
10 = TEXT 10 { value = eins,zwei split { token = , cObjNum = 1||2 1.10 = TEXT 1.10.value = Text 1.10.setContentToCurrent = 1 1.10.wrap = <p>|</p> 1.20 = TEXT 1.20.current = 1 2.current = 1 2.wrap = <p>|</p> } } Ausgabe: <p>Text</p>Text<p>zwei</p>
Ersetzt wie setContentToCurrent den aktuellen Wert des Elternelements, hier wird der Wert aber manuell als String angegeben. stdWrap-Funktionen sind anwendbar.
10 = TEXT 10 { value = eins,zwei split { token = , cObjNum = 1||2 1.10 = TEXT 1.10.setCurrent = Text 1.10.current = 1 1.10.wrap = <p>|</p> 1.20 = TEXT 1.20.current = 1 2.current = 1 2.wrap = <p>|</p> } } # Ausgabe: <p>Text</p>Text<p>zwei</p>
Wie oben bereits erklärt, kann man mit setContentToCurrent und setCurrent selbst Werte übergeben. Hierzu muss kein Wert vorhanden sein, den man dann überschreibt - der Wert eines jeden cObjects kann auf diese Weise als Variable gespeichert werden.
In den folgenden Beispielen wird jeweils ein Wrap mit dynamischem Inhalt (aktuelle Seiten-ID) als current-Wert gespeichert und anschließend zwei verschiedenen cObjects als outerWrap übergeben.
Während der current-Wert im ersten Beispiel innerhalb von setCurrent erstellt wird, erfolgt im zweiten Fall die Zuweisung mittels setContentToCurrent, nachdem die gewünschten Angaben per COA generiert werden. Das Ergebnis ist in beiden Fällen dasselbe. Dennoch sollte man bei dynamischen Werten z.B. aus Datenbankfeldern setContentToCurrent verwenden, weil dies die Arbeit erleichtert und mehr Möglichkeiten bietet.
10 = TEXT 10 { setCurrent = <div class="{field:uid}">|</div> setCurrent.insertData = 1 cObject = COA cObject { 10 = TEXT 10.field = title 10.required = 1 10.outerWrap.current = 1 20 = TEXT 20.field = description 20.required = 1 20.outerWrap.current = 1 } }
20 = COA 20 { 10 = TEXT 10.field = uid # Leerzeichen bei '<div' nur wegen Fehler im Syntax-Highlighting: 10.wrap = < div class="|"> 20 = TEXT 20.value = |</div> stdWrap.setContentToCurrent = 1 stdWrap.cObject = COA stdWrap.cObject { 10 = TEXT 10.field = title 10.required = 1 10.outerWrap.current = 1 20 = TEXT 20.field = description 20.required = 1 20.outerWrap.current = 1 } }
<div class="65">Ebene 1</div> <div class="65">Beschreibung</div>