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

cellWidth verfügbar ab Version 1.7.027

String

Gibt die Breite das Kontrollelement Bereiches für das gesamte Element an.

Anmerkung: Gültiger HTML Größenangabe.

colspan

Integer

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

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

join

Boolean

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

labelWidth verfügbar ab Version 1.7.027

String

Gibt die Breite das Label Bereiches für das gesamte Element an.

Anmerkung: Gültige HTML Größenangabe.

orientation

OrientationType

Gibt die Ausrichtung der Gruppenelemente an.

horizontal = Horizontale Ausrichtung (von links nach rechts). Dies entspricht genau dem <forms:row> Tag
vertical = Vertikale Ausrichtung (von oben nach unten)

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.

styleId

String

Über dieses Attribut kann direkt ein HTML-id Attribut angegeben werden.

Anmerkung: Siehe HTML Dokumentation für das Attribut id.

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:group>`

[ 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
cellWidth	String	Gibt die Breite das Kontrollelement Bereiches für das gesamte Element an. Anmerkung: Gültiger HTML Größenangabe.
colspan	Integer	Gibt bei einem mehrspaltigen Formular die Anzahl der Spalten an, welche von dem Formularelement belegt werden sollen.
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
join	Boolean	Mit diesem Flag wird angegeben ob das Vormularelement mit dem vorhergehenden Element verbunden werden soll. Zwischen verbundenen Formularelementen werden keine Trennungslinien gezeichnet.
labelWidth	String	Gibt die Breite das Label Bereiches für das gesamte Element an. Anmerkung: Gültige HTML Größenangabe.
orientation	OrientationType	Gibt die Ausrichtung der Gruppenelemente an. horizontal = Horizontale Ausrichtung (von links nach rechts). Dies entspricht genau dem <forms:row> Tag vertical = Vertikale Ausrichtung (von oben nach unten)
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.
styleId	String	Über dieses Attribut kann direkt ein HTML-id Attribut angegeben werden. Anmerkung: Siehe HTML Dokumentation für das Attribut id.
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