Die Common-Controls Tag Bibliothek

Attribut	Typ	Beschreibung	Pflicht	RTExp
border	Integer	Gibt die Stärke des Rahmens an, welcher um das Kontrollelement gezeichnet werden soll.
height	String	Setzt die Höhe des Kontrollelmentes. Die Höhe kann absolut oder prozentual angegeben werden. Es hängt vom jeweiligen Kontrollelement Painter ab, ob diese Information ausgewertet wird Siehe HTML-Dokumentation
permission	ACL	Mit diesem Attribut kann der Zugriff auf das Element beschränkt werden. Berechtigungen werden über das Principal Objekt in der Benutzer Session geprüft. Das Principal Objekt wird mit der Methode SecurityUtil.registerPrincipal() in der Session registriert. Es wird vom Anwendungsentwickler durch Implementierung des Principal Interfaces zur Verfügung gestellt. Somit lassen sich sehr einfach beliebige Berechtigungssysteme mit dem Framework verbinden. Berechtigungen werden immer in Form einer Access Control List (ACL) angegeben. Dabei handelt es sich um einen Ausdruck dessen Elemente Einzelberechtigungen sind. Das Framweork unterstützt die folgenden Berechtigungstypen, welche jedoch vom Anwendungsentwickler beliebig erweitert werden können: Literal true\|false -> StaticPermission Rolle #rollenname -> RoleBasedPermission Funktion $funktionsname -> FunctionBasedPermission Zur Formulierung der Ausdrücke kann die folgende Syntax verwendet werden: PERMISSION_PREFIX : '#' \| '$' AND_OP : 'and' \| '&' \| '' XOR_OP : 'xor' \| '^' OR_OP : 'or' \| '\|' \| '+' UNARY_OP : '~' \| '!' permission : PERMISSION_PREFIX IDENTIFIER primary_expr : permission \| '(' expr_list ')' unary_expr : primary_expr \| UNARY_OP primary_expr logical_and_expr : unary_expr \| logical_and_expr AND_OP unary_expr logical_xor_expr : logical_and_expr \| logical_or_expr XOR_OP logical_and_expr logical_or_expr : logical_xor_expr \| logical_or_expr OR_OP logical_xor_expr expr_list : logical_or_expr \| expr_list ';' logical_or_expr \| expr_list ',' logical_or_expr Access Control Listen werden mit der statischen Methode AccessControlList.parse() eingelesen. Der Parser verwendet wiederum die statische Methode PermissionFactory.parse() um die einzelnen Permissions zu lesen. Der Anwendungsentwickler kann über die PermissionFactory eigene von Permission abgeleitete Klassen registrieren und so den Sprachumfang der ACL* erweitern.
summary	String	Gibt einen nicht sichtbaren Summary zu dem Kontrollelement auf der HTML Seite aus. Diese Information kann von speziellen Anzeigegeräten dargestellt werden - zum Beispiel als Sprachausgabe oder Braille Schrift.
valign	AlignmentType	Gibt die Ausrichtung des Frames in dem umschliessenden Container an. top = Ausrichtung oben bottom = Ausrichtung unten
width	String	Setzt die Breite des Kontrollelmentes. Die Breite kann absolut oder prozentual angegeben werden. Siehe HTML-Dokumentation

Verwendung des Innerframe-Tags

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

<html:form action="sample102/carBrowse" method="post">

<ctrl:list
   styleId="carlist1"
   name="cars"
   title="car.list.title"
   width="465"
   rows="7"
   minRows="7"
   select="multiple"
   formElement="true">

   <base:innerframe border="false">
      Inner Frame 1 (no border)
   </base:innerframe>

   <ctrl:columncheck   property="checkState"    checkAll="true"                width="50"/>
   <ctrl:columntext          title="car.list.id"      property="id"         width="65"/>
   <ctrl:columntext   title="car.list.name"    property="name"      width="350"/>
   <ctrl:columntext   title="car.list.manuf"   property="manufacturerName"   width="150"/>

   <base:innerframe border="true">
      Inner Frame 2
   </base:innerframe>

</ctrl:list>

</html:form>

`<base:innerframe>`

[ Syntax ]

Standard Syntax

[ Attribute ]

[ Beispiel ]