Die Common-Controls Tag Bibliothek

<menu:ctx>

Setzt den Menükontext direkt in der JSP-Seite.

Die Anwendung verfügt über genau einen Menükontext je Benutzersitzung. Dieser gibt an welcher Menüpunkt aktuell aktiv ist. Dies geschieht durch die Festlegung des aktuellen Menü Kontextpfades

Der Menükontext kann mit diesem Tag direkt in einer JSP-Seite angegeben werden, oder er wird in der Anwendung vor dem Aufruf der JSP-Seite mit der Methode MenuContext.setPath() gesetzt.

Der Menükontext wirkt sich auf den Selektionsstatus aller Menü Kontrollelemente aus.


Tag class: ContextTag
 

[ Syntax ]

Standard Syntax
<menu:ctx
[ filter = "String" ]
[ path = "String" ]
/>
 

[ Attribute ]

AttributTypBeschreibungPflichtRTExp
filterString Setzt den aktuellen Menü Kontextfilter.

Jeder Menüpunkt kann optional mit einer Filterliste versehen werden. Menüpunkte werden nur dann angezeigt wenn sie

  • über keine Filterliste verfügen
  • über eine Filterliste verfügen und der Kontextfilter als Zeichenkette in dieser Liste vollständig enthalten ist.
Der Kontextfilter kann auch in der Anwendung mit Hilfe der Methode MenuContext.setFilter() gesetzt werden. 		 
pathString Legt den aktuellen Menü Kontextpfad fest. Der Kontextpfad legt fest welcher Menüeintrag selektiert ist.

Jedem Menüelement (Menü oder Menüeintrag) ist ein hierarchischer Menüpfad zugeordnet. Er wird über die Menühierarchie hinweg durch Konkatenation der Menü Id's festgelegt.

Ein Menüelement gilt als selektiert, wenn der Kontextpfad mit dessen Menüpfad beginnt.

Beispiel:

Die Id eines Menüs ist "admin/tools" und der aktuelle Kontextpfad ist auf "admin/tools/dbquery" eingestellt.
  • Das ganze Menü gilt damit als selektiert.
  • Ein untergeordneter Menüpunkt mit der Id "dbquery" würde nun als aktiver Menüpunkt dargestellt, da dessen vollständiger im Menüpfad "admin/tools/dbquery" in dem Kontextpfad passt.
  • Der untergeordnete Menüpunkt mit der Id "sessionlist" würde als unselektierter Menüpunkt dargestellt, da sein vollständiger Menüpfad "admin/tools/sessionlist" nicht in den Kontextpfad passt.

Anmerkung: Die einzelnen Pfadelemente werden mit "/" getrennt

 

[ Beispiel ]

Setzt den Menükontext der aktuellen Seite und selektiert den Menüpunkt "admin/tools/dbquery"


<%@ taglib uri="http://www.common-controls.com/cc/tags-menu"  prefix="menu" %>

<menu:ctx path="admin/tools/dbquery" filter=""/>

                  
© 2000 - 2007 by www.common-controls.com (erstellt mit Common Controls TLDFactory)