The Common-Controls Tag Library

<ctrl:panel>

Generates a Panel Window.
The <panel>-tag is used in conjunction with <panelcontent>- inf <panelitem>-tags.
../images/images/panel.gif

Body content: JSP
Tag class: PanelTag
Tei class: PanelTei
 

[ Syntax ]

Standard Syntax
<ctrl:panel
[ action = "String" ]
[ border = "Integer" ]
[ disabled = "boolean" ]
[ formElement = "boolean" ]
[ height = "String" ]
[ id = "String" ]
[ locale = "String" ]
[ name = "String" ]
[ permission = "ACL" ]
[ property = "String" ]
[ runat = "{server | client | auto}" ]
[ scope = "{any | page | request | session | application}" ]
[ shadow = "boolean" ]
[ style = "String" ]
[ styleClass = "String" ]
[ styleId = "String" ]
[ tabindex = "Integer" ]
[ width = "String" ]
>
...Body Content...

</ctrl:panel>
 

[ Attributes ]

AttributeTypeDescriptionReq.RTExp
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.

 
borderInteger Specifies the thickness of the border that has to be drawn around the control element.  
disabledboolean This attribute can be used to disable the control element. It then does not accept any user inputs and does not generate any control element events.  
formElementboolean This attribute is used to control how the control element should behave in case of a user action.
As form element
A submit of the surrounding form is carried out. All the information about the control element event is transported to the server in hidden fields.
As an independent control element
Control element events are directly triggered in the form of hyperlinks. All the data input in the HTML page is then lost.
Internally, this attribute is used to control how the control element should generate Painter links - as HTML-A tags or HTML-Input tags.

Annotation: The value true may only be used when the control element is situated in a form.

 
heightString Sets the height of the control element. The height may be specified in absolute or percent terms.

See the HTML documentation

 
idString The name of a page scope JSP bean that will contain the current element. Using the given Id, the variable can be accessed in scripting expressions in the tag Body. The id mus be a string lteral because the JSP compiler generates a variable withthis name at compile time

Annotation: A valid Java identifier must be given.

 
localeString enables localization for the control element. String literals will be interpreted as keys in the Application.properties file.

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

 
nameString Specifies the name of the Java-Bean. The Java-Bean must be stored in the given scope.

When the tag is surrounded by a Struts <html:form> tag, no Bean Name need be specified. In this case, the Java-Bean is drawn via a property of the Struts Form Bean.

Annotation: A valid Java identifier must be given.

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

Authorizations are checked using the com.cc.framework.security.Principal object in the user session. The principal object is registered in the session with the method com.cc.framework.security.SecurityUtil#registerPrincipal(HttpSession, 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:

Literal
true|false -> com.cc.framework.security.StaticPermission
Role
#rolename -> com.cc.framework.security.RoleBasedPermission
Function
$functionname -> com.cc.framework.security.FunctionBasedPermission

 
propertyString Specifies the name of the property using which the Java-Bean is to be accessed. This is generally only necessary when the Java-Bean is associated with a Struts Form Bean.

Annotation: A valid Java identifier must be given.

 
runatRunAt This attribute specifies whether, for the control element, Clientside JavaScript should be used, or whether the control element should work purely with Server Roundtrips.
  • server = All control element actions result in a Server Roundtrip and are processed on the server.
  • client = control element actions are carried out directly in the browser of the user. It depends on the Painter Factory used and the specific control element, how far the support for Clientside Scripting goes!
  • auto = The framework selects based on the users browser settings "client" when JavaScript is enabled and "server" when JavaScript is disabled.
 
scopeHTTPScope This attribute shows the Scope in which the Java-Bean with the actual display data can be found.
  • any = The Bean is searched for in ever Scope.
  • page = The Bean exists as a local variable in the JSP Page.
  • request = The Bean is in the HTTP-Request.
  • session = The Bean is in the HTTP-Session.
  • application = The Bean is in the Servletkontext.
 
shadowboolean Specifies whether the control element should be saved with a shadow.

This function is only available in the case of specific Painterfactories.

 
styleString An HTML-style can be directly specified with this attribute.

Annotation: See HTML documentation for the attribute style.

 
styleClassString The HTML-class attribute of the element can be specified with this attribute.

Annotation: See HTML documentation for the attribute class.

 
styleIdString The HTML-id attribute of the element can be specified with this attribute.

Annotation: See HTML documentation for the Attribute id.

 
tabindexInteger Tabulator Index for this element.  
widthString Sets the width of the control element. The height may be specified in absolute or percent terms.

See the HTML documentation

 

[ Example ]

Generates a panel for selecting program functions.


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

<ctrl:panel  id="myPanel"  width="170">
    <ctrl:panelcontent title="Reporting">
        <base:image src="images/icons/imgReports.gif"/>
            <ctrl:panelitem  action="/report?report=MI"  title="Miscellaneous"/>
    </ctrl:panelcontent>

    <ctrl:panelcontent title="Finance Reporting" permission="#admin;#manager">
        <ctrl:panelitem action="/report?report=FAct"  title="Actuals"/>
            <ctrl:panelitem  action="/report?report=FSpl"  title="Strategic Plans"/>
            <ctrl:panelitem  action="/report?report=FOpl"  title="Operational Plans"/>
    </ctrl:panelcontent>

    <ctrl:panelcontent title="Market Reporting" permission="#admin;#prodman">
            <ctrl:panelitem  action="/report?report=MSpl"  title="Strategic Plans"/>
            <ctrl:panelitem  action="/report?report=MOpl"  title="Operational Plans"/>
    </ctrl:panelcontent>
</ctrl:panel>