Die Common-Controls Tag Bibliothek

Rolle	Java Klasse
Designmodel	ColumnHeaderDesignModel

ajax

Boolean

Aktiviert die AJAX Funktion der Spalte. Alle Ereignisse werden dann mit JavaScript asynchron an den Server gesendet und dort verarbeitet.

Die Verarbeitung auf dem Server unterscheidet sich nicht von einer normalen Request Behandlung. Der Anwendungsentwickler hat jedoch die Möglichkeit über die Methoden des AjaxRequest Interfaces (Basisklasse von ActionContext) die Ergebnis Rückmeldung zu steuern.

Im Normalfall (-> AjaxRequest.isAjaxCanceled() == false) wird ein Delta XML Stream zum Web Browser zurückgeschickt. Dieser Stream enthält nur die schmutzigen Kontrollelemente, welche dann mit Hilfe eines JavaScript Handlers vom Web Browser im HTML DOM Tree selektiv ausgetauscht werden. Es wird also keine vollständige HTML Seite vom Server übertragen!

(+) Die übertragene Datenmenge ist kleiner.
(+) Die HTML Seite bleibt im Browser stehen und es gibt kein "flackern".
(-) Der Request wird nicht in der Browser Historie vermerkt!
(-) Es wird JavaScript benötigt, sonst wird ein normaler Server roundtrip ausgelößt

Die meisten Kontrollelemente fügen sich selbst in die Dirty Liste des ActionContext ein. Hierzu wird einfach die Methode AjaxRequest.markDirty() aufgerufen. Der Anwendungsentwickler hat damit die Möglichkeit noch weitere Kontrollelemente - die durch eine Zustandsänderung ebenfalls schmutzig geworden sind - in den Delta Stream aufzunehmen

Wenn der Request eine vollständig neue HTML Seite zurückgeben soll, dann besteht auch die Möglichkeit die AJAX Verarbeitung auf dem Server abzubrechen. Hierzu wird die Methode AjaxRequest.cancelAjaxRequest() aufgerufen. Das Framework sendet danach immer eine vollständige HTML Seite zurück an den Web Browser.

Das Common-Controls AJAX XML Protokoll hat das folgende Format:


<?xml version="1.0" encoding="UTF-8" ?>
<ajax-response>
	<token/>
	<controls>
		<control styleId="" class="" name="">
			<html>
				<[CDATA[...]] >
			</html>
		</control>
	</controls>
</ajax-response>

align

AlignmentType

Gibt die Ausrichtung der Spalte an.

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

filter

Boolean

Mit dem filter-Attribut kann die automatische HTML-Codierung des Spalteninhaltes 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.

imagemap

String

Gibt den Namen einer ImageMap an, welche im Request abgelegt sein muss. Die Werte welche das imageProperty liefert werden auf die Einträge dieser ImageMap abgebildet. Die Abbildung erfolgt anhand des regulären Ausdrucks welcher jedem Eintrag der ImageMap zugeordnet ist.

Anmerkung: Unter dem Namen muss eine ImageMap im Request abgelegt sein.

imageref

String

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

Die ImageMap wird mit Hilfe des imagemap Attributes gesetzt

maxlength

Integer

Gibt die maximale Zeichenzahl für die Anzeige in Spaltenüberschriften und Zellen an. Weitere Zeichen werden durch "..." angedeutet.
Diese Funktionalität ist unwirksam, wenn das Attribut filter="false" gesetzt ist, da in diesem Fall die tatsächlich sichtbare Zeichenzahl nicht ermittelt werden kann.

onblur

String

Fires when the object loses the input focus.