Die Common-Controls Tag Bibliothek

<ctrl:calendar>

Das Tag erzeugt ein Eingabefeld für einen Datums- und und Uhrzeitwert mit der Möglichhkeit zur Auswahl eines Datums aus einem Kalender.

Verwendete Java Klassen/Interfaces:

RolleJava Klasse
ControlCalendarControl
DesignmodelCalendarDesignModel
../images/images/calendar_ctrl.gif

Body content: JSP
Tag class: CalendarTag
 

[ Syntax ]

Standard Syntax
<ctrl:calendar
[ buttonAlt = "String" ]
[ buttonTooltip = "String" ]
[ converter = "Java Klassenname oder Converter Id" ]
[ disabled = "Boolean" ]
[ format = "String" ]
[ id = "String" ]
[ layout = "String" ]
[ maxlength = "Integer" ]
[ mode = "{popup | inline}" ]
[ name = "String" ]
[ onblur = "String" ]
[ onchange = "String" ]
[ onclick = "String" ]
[ oncontextmenu = "String" ]
[ ondblclick = "String" ]
[ onfocus = "String" ]
[ onkeydown = "String" ]
[ onkeypress = "String" ]
[ onkeyup = "String" ]
[ onmousedown = "String" ]
[ onmousemove = "String" ]
[ onmouseout = "String" ]
[ onmouseover = "String" ]
[ onmouseup = "String" ]
[ property = "String" ]
[ scope = "{any | page | request | session | application}" ]
[ showButton = "{true | false}" ]
[ showformat = "{none | right | bottom}" ]
[ size = "Integer" ]
[ style = "String" ]
[ styleId = "String" ]
[ tabindex = "Integer" ]
[ tooltip = "String" ]
[ value = "String" ]
>
...Body Content...

</ctrl:calendar>
 

[ Attribute ]

AttributTypBeschreibungPflichtRTExp
buttonAltString Gibt den alternativen Text an, welcher ausgegeben wird, wenn die Anzeige von Images im Browser deaktiviert wurde.  
buttonTooltipString Ein Kurzer Hinweistext, welcher angezeigt wird, wenn der Anwender den Mauszeiger über das Element bewegt.  
converterJava Klassenname oder Converter Id Gibt den Datentyp Konverter an mit welchem die Daten des Kontrollelementes konvertiert werden sollen. Wird dieses Attribut nicht angegeben, so verwendet das Framework einen Default Konverter passend zum Datentyp des Kontrollelementes. (ConverterRegistry.lookup()).

Der Konverter kann auf die folgenden Arten angegeben werden:

  • Es wird die öffentliche Converter Id angegeben.
  • Es wird der voll qualifizierter Java Klassenname des Konverters angegeben. Dieser muss das Converter Interface implementieren

Anmerkung: Die angegebene Java Klasse muss das Converter Interface implementieren!

 
disabledBoolean Über dieses Attribut kann das Kontrollelement deaktiviert werden. Es nimmt dann keine Benutzereingaben entgegen und erzeugt keine Kontrollelement Ereignisse.  
formatString Gibt eine Formatmaske an welche das Datums- und Uhrzeitformat festlegt.
MaskeBeispiel
yy/MM/dd04/05/31
dd/MM/yyyy12/05/2004
DDDDMontag
DDDD yyyy-MM-ddMontag 2004-04-31
HH:mm15:33
HH:mm:ss15:33:20
HH:mm:ss tt03:33:20 PM
HH:mm 'Uhr'15:33 Uhr
DDDD yyyy-MM-dd HH:mm:ss ttMontag 2004-04-31 07:29:59 AM

Wenn keine Maske und auch kein Konverter angegeben wird, dann ermittelt das Framework das Datumsformat über den Ressourcen Schlüssel fw.calendar.dateformat.

 
idString Weist dem Kontrollelement einen eindeutigen Bezeichner zu. Im Tag Body wird daraufhin eine Java Variable angelegt, auf die in Java Scriptlets zugegriffen werden kann. Diese Variable verweist auf die Kontrollelement Instanz (abgeleitet von Control).

Dieses Attribut wird meist in Verbindung mit dem type Attribut verwendet

Anmerkung: Da zur JSP Compile Zeit eine Java Variable mit diesem Bezeichner angelegt wird, muss hier ein String Literal (und keine Expression!) angegeben werden! Der Bezeichner muss den Regeln für gültiger Java Bezeichner folgen.

 
layoutString Gibt das für den Kalender zu verwendete JSP Template an. Ein Templates dient zur Anpassung eines Kalenders.  
maxlengthInteger Gibt die maximale Zeichenzahl für die Dateneingabe an.  
modeCalendarMode Gibt an wie sich das Kalender Fenster verhalten soll bzw. wie das Datum dargestellt werden soll.
  • popup = Die Schaltfläche neben dem Datums Eingabefeld öffnet einen Popup Kalender (Standard)
  • inline = Die Schaltfläche neben dem Datums Eingabefeld öffnet einen inline Kalender. Der inline Kalender besitzt keinen Fenster Rahmen.
 
nameString Gibt den Namen der Java-Bean - eine Instanz der Klasse Control. Die Java-Bean muss im angegebenen Scope abgelegt sein.

Wenn das Tag von einem Struts <html:form> Tag umschlossen ist, dann muss kein Bean Name angegeben werden. In diesem Fall wird die Java-Bean über ein Property der Struts Formular Bean gezogen.

Anmerkung: Es muss ein gültiger Java Bezeichner angegeben werden.

 
onblurString Fires when the object loses the input focus.

Anmerkung: JavaScript Code

 
onchangeString Fires when the contents of the object or selection have changed.

Anmerkung: JavaScript Code

 
onclickString Fires when the user clicks the left mouse button on the object.

Anmerkung: JavaScript Code

 
oncontextmenuString Fires when the user clicks the right mouse button in the client area, opening the context menu.

Anmerkung: JavaScript Code

 
ondblclickString Fires when the user double-clicks the object.

Anmerkung: JavaScript Code

 
onfocusString Fires when the object receives focus.

Anmerkung: JavaScript Code

 
onkeydownString Fires when the user presses a key.

Anmerkung: JavaScript Code

 
onkeypressString Fires when the user presses an alphanumeric key.

Anmerkung: JavaScript Code

 
onkeyupString Fires when the user releases a key.

Anmerkung: JavaScript Code

 
onmousedownString Fires when the user clicks the object with either mouse button.

Anmerkung: JavaScript Code

 
onmousemoveString Fires when the user moves the mouse over the object.

Anmerkung: JavaScript Code

 
onmouseoutString Fires when the user moves the mouse pointer outside the boundaries of the object.

Anmerkung: JavaScript Code

 
onmouseoverString Fires when the user moves the mouse pointer into the object.

Anmerkung: JavaScript Code

 
onmouseupString Fires when the user releases a mouse button while the mouse is over the object.

Anmerkung: JavaScript Code

 
propertyString Gibt den Namen des Properties an, über welchen auf die Java-Bean zugegriffen werden soll. Dies ist in der Regel nur dann notwendig, wenn die Java-Bean mit einer Struts Formular Bean assoziiert ist.

Anmerkung: Es muss ein gültiger Java Bezeichner angegeben werden.

 
scopeHttpScope Dieses Attribut gibt den Scope an, in welchem die Java-Bean mit den eigentlichen Anzeigedaten zu finden ist.
  • any = Nach der Bean wird in jedem Scope gesucht.
  • page = Die Bean liegt im PageContext der JSP Seite.
  • request = Die Bean liegt im HTTP Servlet Request
  • session = Die Bean liegt in der HTTP Session
  • application = Die Bean liegt applikationsweit im Servlet Kontext
 
showButtonboolean Gibt an ob der Button hinter dem Feld zum öffnen des Kalenders angezeigt werden soll.
  • true = Der Button wird angezeigt.
  • false = Der Button wird nicht angezeigt.
 
showformatString Gibt an ob zu dem Kalender Feld auch die Formatmaske ausgegeben werden soll.
  • none = Es wird keine Formatmaske ausgegeben (Standard)
  • right = Gibt die Formatmaske hinter dem Feld aus
  • bottom = Gibt die Formatmaske unter dem Feld aus
 
sizeInteger Gibt die Anzahl der sichtbaren Zeichen an.  
styleString Über dieses Attribut kann direkt ein HTML-style Attribut angegeben werden.

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

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

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

 
tabindexInteger Legt den Tabulator Index für dieses Element fest.  
tooltipString Tooltip Text welcher in einem Popup Fenster angezeigt wird, wenn der Benutzer die Maus über das Kontrollelement bewegt.

Die Zeichenkette wird vor der Ausgabe HTML-codiert

 
valueString Der Wert des Kontrollelementes kann mit diesem Attribut auch direkt als Litteral angegeben werden.  

[ Beispiel ]

Kalender


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

<ctrl:calendar name="mybean" property="date" maxlength="10" size="8"  format="dd/mm/yyyy"  showformat="right"/>

                  
© 2000 - 2007 by www.common-controls.com (erstellt mit Common Controls TLDFactory)