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
@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>