Die Common-Controls Tag Bibliothek

align

AlignmentType

Gibt die horizontale Ausrichtung in der Formularelement Zelle an

left = linksbündige Ausrichtung
right = rechtsbündige Ausrichtung
center = zentrierte Ausrichtung

colspan

Integer

Gibt bei einem mehrspaltigen Formular die Anzahl der Spalten an, welche von dem Formularelement belegt werden sollen.

description

String

Der Beschreibungstext

filter

Boolean

Mit dem filter-Attribut kann die automatische HTML-Codierung des Formularelementes aktiviert bzw. deaktiviert werden.

true = Die HTML Konvertierung ist aktiv. So wird beispielsweise das "<" Zeichen als "<" codiert. HTML Code wird damit nicht ausgeführt.
false = Die HTML Konvertierung ist abgeschaltet. HTML Code wird demzufolge direkt in die Seite eingesetzt und somit ausgeführt.

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

imageref

String

Verweis auf ein Element der ImageMap des Formulars. Das Image wird vor dem Label des Formularelementes gezeichnet.

Die ImageMap wird im umschliessenden Formular Tag mit Hilfe des imagemap Attributes gesetzt

join

Boolean

Mit diesem Flag wird angegeben ob das Vormularelement mit dem vorhergehenden Element verbunden werden soll. Zwischen verbundenen Formularelementen werden keine Trennungslinien gezeichnet.

label

String

Das Label des Formularelementes.

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.

valign

AlignmentType

Gibt die vertikale Ausrichtung in der Formularelement Zelle an

top = Ausrichtung oben
bottom = Ausrichtung unten
center = Ausrichtung zentriert

width

String

Setzt die Breite des Kontrollelmentes. Die Breite kann absolut oder prozentual angegeben werden.

Siehe HTML-Dokumentation

`<forms:description>`

[ Syntax ]

Standard Syntax

[ Attribute ]

[ Beispiel ]

Attribut	Typ	Beschreibung	Pflicht	RTExp
align	AlignmentType	Gibt die horizontale Ausrichtung in der Formularelement Zelle an left = linksbündige Ausrichtung right = rechtsbündige Ausrichtung center = zentrierte Ausrichtung
colspan	Integer	Gibt bei einem mehrspaltigen Formular die Anzahl der Spalten an, welche von dem Formularelement belegt werden sollen.
description	String	Der Beschreibungstext
filter	Boolean	Mit dem filter-Attribut kann die automatische HTML-Codierung des Formularelementes aktiviert bzw. deaktiviert werden. `true` = Die HTML Konvertierung ist aktiv. So wird beispielsweise das "<" Zeichen als "<" codiert. HTML Code wird damit nicht ausgeführt. `false` = Die HTML Konvertierung ist abgeschaltet. HTML Code wird demzufolge direkt in die Seite eingesetzt und somit ausgeführt.
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
imageref	String	Verweis auf ein Element der ImageMap des Formulars. Das Image wird vor dem Label des Formularelementes gezeichnet. Die ImageMap wird im umschliessenden Formular Tag mit Hilfe des imagemap Attributes gesetzt
join	Boolean	Mit diesem Flag wird angegeben ob das Vormularelement mit dem vorhergehenden Element verbunden werden soll. Zwischen verbundenen Formularelementen werden keine Trennungslinien gezeichnet.
label	String	Das Label des Formularelementes.
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.
valign	AlignmentType	Gibt die vertikale Ausrichtung in der Formularelement Zelle an top = Ausrichtung oben bottom = Ausrichtung unten center = Ausrichtung zentriert
width	String	Setzt die Breite des Kontrollelmentes. Die Breite kann absolut oder prozentual angegeben werden. Siehe HTML-Dokumentation