Batix-Tags Referenz

Hinweis für (fast) alle Tags: für Parameterwerte können auch Präfix-Variablen eingesetzt werden.

Syntax-Konventionen

<bx:tag1.{command} static="value" [not] />
<bx:tag2 [optional="(option1 | option2)"] />
<bx:tag3 [first | last] />
<bx:tag4 required="(option1 | option2)">{content}</bx:tag> <!-- 'content' darf auch leer sein -->

Zur besseren Lesbarkeit steht ein Leerzeichen vor dem Ende selbstschließender Tags, also vor />.

Platzhalter sind mit { } umschlossen (siehe command und content). Im Beschreibungstext der Tags werden die Platzhalter genauer bestimmt, z.B. welche Werte oder Typen zugelassen sind.

Optionaler Code ist mit [ ] umschlossen (siehe not, optional und first / last). Dies bedeutet, dass dieser Bereich komplett weggelassen werden kann.

Pflichtauswahlen werden mit ( ) und Auswahlen, die auch komplett weggelassen werden können, werden mit [ ] umschlossen. Die jeweiligen Möglichkeiten sind durch | getrennt.

Falls unbedingt nötig, sind Kommentare in der Form <!-- Kommentartext --> eingefügt, diese Art der Beschreibung sollte allerdings nur in Ausnahmefällen auftauchen.

Diese Beispiele sind laut der obigen Definition valide:

<bx:tag1.replace static="value" />
<bx:tag2 />
<bx:tag2 optional="option1" />
<bx:tag3 />
<bx:tag3 first />
<bx:tag4 required="option2">Lorem Ipsum</bx:tag>

Die folgenden Beispiele sind allerdings nicht valide (das Kommentar hinter jedem Beispiel beschreibt warum):

<bx:tag1 static="value" />       <!-- der Platzhalter 'command' muss gefüllt werden -->
<bx:tag1.replace />              <!-- der Parameter 'static' muss exakt aus der Definition übernommen werden -->
<bx:tag2 optional="option3" />   <!-- 'option3' steht nicht zur Auswahl -->
<bx:tag2 optional="" />          <!-- es muss eine der Optionen gewählt werden -->
<bx:tag3 middle />               <!-- 'middle' steht nicht zur Auswahl -->
<bx:tag4 required=""></bx:tag>   <!-- es muss eine Option für 'required' gewählt werden, leerer Taginhalt ist laut Kommentar in Ordnung -->