The Common-Controls Tag Library


The actual entries of a panel are defined with this tag.
The <panelitem>-tag must always be enclosed within a <panelcontent>-tag.

Tag class: PanelItemTag

[ Syntax ]

Standard Syntax
title = "String"
[ action = "String" ]
[ detail = "String" ]
[ filter = "boolean" ]
[ locale = "String" ]
[ onclick = "String" ]
[ oncontextmenu = "String" ]
[ permission = "ACL" ]
[ target = "String" ]
[ tooltip = "String" ]

[ Attributes ]

actionString Specifies the Struts Action that is to be called in case of control element events.

This attribute need not be specified if the tag is included within a Struts <html:form> tag. In that case, the name of the action is determined using the Struts Form Bean.

Annotation: The action must be declared in one of the struts-config.xml files.

detailString An additional descriptive text that is output below the title.

The character string is HTML-coded before outputting.

filterboolean This flag specifies whether an HTML-conversion of the title and detal parameters should be carried out.  
localeString enables localization for the control element. String literals will be interpreted as keys in the file.

Annotation: boolean value true oder false oder the name of a locale.

onclickString Fires when the user clicks the left mouse button on the object.

Annotation: JavaScript Code

oncontextmenuString Fires when the user clicks the right mouse button in the client area, opening the context menu.

Annotation: JavaScript Code

permissionACL With this attribute, access to the element can be restricted.

Authorizations are checked using the object in the user session. The principal object is registered in the session with the method, Principal). It is made available by the application developer by implementing the principal interface. In this manner, any authorization system can be very easily connected within the framework.

Authorizations are always specified in the form of an Access Control List (ACL). What is involved here is a semicolon-delimited list with individual authorizations. The framweork supports the following authorization types, which, however, can be expanded at will by the application developer:

true|false ->
#rolename ->
$functionname ->

targetString This attribut is used to specify the HTML-target attribut.  
titleString The title of the item. It is mostly used as a hyperlink for calling the specified action.

The character string is HTML-coded before outputting.

tooltipString Tooltip Text that is displayed in a Popup window when the user moves the mouse over the title.

The character string is HTML-coded before outputting.


[ Example ]

Generates a panel with a miscellaneous group.

<%@ taglib uri=""    prefix="ctrl" %>

<ctrl:panel id="myPanel" width="170">
    <ctrl:panelcontent title="Miscellaneous">
        <ctrl:panelitem  action="/userprofile"  title="User Profile"     detail="Edit your User Profile"/>
        <ctrl:panelitem  action="/changepwd"    title="Change Password"  detail="Change your password"/>