bx:navigation
Allgemeine Syntax
<bx:navigation.{level} [normal | protected | showcurrentinactive] [open]>Inhalt</bx:navigation.<level>>
level
Um darunterliegende Menüpunkte anzuzeigen, werden bx:navigation-Tags geschachtelt (jeweils das Level um 1 erhöhen)
normal / protected / showcurrentinactive
- normal: nur nicht-geschützte Menüpunkte anzeigen
- protected: nur geschützte (Intranet-)Menüpunkte anzeigen
- showcurrentinactive: wird angezeigt, wenn man sich gerade in diesem inaktiven Menüpunkt befindet
open
geöffnete Menüpunkte anzeigen
Ab Version 2.6.2 kann man auch auf Seiteninhalte zugreifen, so wie bei bx:submenu.
Beispiele
<bx:navigation.0>
<a href="<bx:navigation.path/>"><bx:navigation.name/></a><br>
<bx:navigation.1>
<a href="<bx:navigation.path/>">-<bx:navigation.name/></a><br>
<bx:navigation.2>
<a href="<bx:navigation.path/>">--<bx:navigation.name/></a><br>
</bx:navigation.2>
</bx:navigation.1>
</bx:navigation.0>
Beispiel für geschachtelte Navigation
navigation.path
<bx:navigation.path/>
Der virtuelle Pfad wird ohne "/www/webname/" und ohne "/" am Ende ausgegeben (siehe Beispiel oben).
navigation.dir
<bx:navigation.dir/>
Es wird nur der aktuelle Verzeichnisname ausgegeben.
navigation.name
<bx:navigation.name/>
Dieses Tag gibt den angezeigten Name des Menüpunktes aus.
navigation.target
<bx:navigation.target [default="{ziel}"] />
Das Zielframe wird ausgegeben.
ziel
Standard-Zielframe, wenn im Menüpunkt kein Zielframe angegeben wurde
navigation.id
<bx:navigation.id/>
Dieses Tag gibt die ID des Menüpunktes aus. Die ID der aktuellen Seite kann auch mit <a href="http://docs.batix.info/display/DEVS/bx%3Apagedata#bx:pagedata-pagedata.navid" target="_blank">bx:pagedata.navid</a> ausgegeben werden.
navigation.index
<bx:navigation.index/>
Es wird eine laufende Nummer innerhalb der Navigations-Schleife ausgegeben. Die Zählung beginnt bei 1 und startet in jedem Unterpunkt neu.
navigation.if
<bx:navigation.if (open | closed | hasChilds | noChilds | self | notself | first | last | notfirst | notlast)> Inhalt </bx:navigation.if>
<bx:navigation.if (id="{id}" | parent="{id}" | path="{pfad}" | redirected [not])> Inhalt </bx:navigation.if>
Mit diesem Tag kann entschieden werden, ob ein bestimmter Quelltext ausgegeben werden soll. Die ID der aktuellen Seite kann auch mit <a href="http://docs.batix.info/display/DEVS/bx%3Apagedata#bx:pagedata-pagedata.nav" target="_blank">bx:pagedata.nav</a> abgefragt werden.
pfad
Menüpunkt-Pfad
open/closed
Menüpunkt ist geöffnet (gilt auch für Überebenen)
hasChilds/noChilds
Abfrage, ob Menüpunk Unterpunkte besitzt
self/notself
aktueller Menüpunkt
first/last/notfirst/notlast
erklärt sich selbst
id
Vergleich des Menüpunkts mit einer ID (mehrere IDs mit Komma, Semikolon oder Leerzeichen getrennt ab v 2.6.2)
parent
Vergleich des übergeordnete Menüpunkts mit einer ID
path
Vergleich des Menüpunktes mit einem bestimmten Pfad
redirected
wenn Menüpunkt weitergeleitet wird
navigation.link
<bx:navigation.link/>
<bx:navigation.link> Linktext </bx:navigation.link> <!-- es kann ein eigener Linktext angegeben werden -->
Es wird ein Link zum aktuellen Navigationspunkt des Schleifendurchlaufs erzeugt. Es werden alle angegebenen Parameter in das HTML-Tag übernommen. Als target für den Link wird der beim Menüpunkt gespeicherte Wert bevorzugt.
Beispiele
<bx:navigation.0>
<bx:navigation.link default="_blank"><span title="<bx:navigation.name/>"><bx:navigation.index/></span></bx:navigation.link><bx:navigation.if notlast> | </bx:navigation.if>
</bx:navigation.0>
Ausgabe: 1 | 2 | 3 | 4 - beim Hover auf die Zahlen erscheint der Menüpunktname. Der letzte Trennstrich wurde ausgeklammert.
navigation.meta
<bx:navigation.meta name="{metaname}"/> <!-- Ausgabe der Meta-Eigenschaft -->
<bx:navigation.meta name="{metaname}" [not]> Inhalt </bx:navigation.meta> <!-- gibt den Inhalt nur aus, wenn die Meta-Eigenschaft existiert bzw. nicht existiert (not) -->
Dieses Tag gibt Meta-Daten zum aktuellen Menüpunkt aus oder prüft, ob diese vorhanden sind. Es kann auch bx:navdata benutzt werden.