art : block

jart.handlers.control.Block

Beschreibung

art:block ist eine Klasse die einerseits für die übersichtliche Anordnung von Code-Blöcken dient die optional mit key-Verhalten versehen werden können und andererseits um Funktions-Blöcke zu definieren die über art:call aufgerufen werden können.

Attribute

Globale Attribute

@function (optional)

Im "function"-Attribut kann ein Funktionsname vergeben werden, welcher über [../art_call art:call aufgerufen werden kann. Ist ein Funktionsname mehr als einmal in Verwendung werden alle Blöcke mit diesem Namen beim Aufruf der Funktion abgearbeitet.

@ comment (optional)

Das "comment"-Attribut dient dazu, Blöcke mit Kommentaren zu versehen um die Übersichtlichkeit im Code zu steigern.

Beispiele

<art:plain name="data">
   <art:block function="recurse" comment="i am a function">
      <art:plain name="node">
         <art:if test="count(ancestor::node) < 3">
            <art:call function="recurse" /> 
         </art:if>
      </art:plain>
   </art:block>
</art:plain>

Ergebnis (XML):
<data>
   <node>
      <node>
         <node>
            <node /> 
         </node>
      </node>
   </node>
</data>

Einfacher block ohne eigene Funktionalität ausser den Globale Attributen

<art:block key="foo">
    ....
</art:block>

Einfacher block ohne eigene Funktionalität nur zur Strukturierung verwendet

<art:block comment="was passiert hier">
    ....
</art:block>

Definition einer Funktion die durch den key "never" nicht im normale Ablauf ausgeführt wird und nur mit dem entsprechenden art:call ausgeführt werden kann

<art:block key="never" function="do_something">
    ....
</art:block>