Die Common-Controls Tag Bibliothek

<forms:label>

Erzeugt ein Label für das umschliessende Formularelement.
Das <label>-Tag darf nur innerhalb von einem Taghandler welcher das com.cc.framework.taglib.forms.LabeledFormelementTag Interface implementiert verwendet werden. Dies sind die meisten <formelementXXXXX>-Tags.

Body content: JSP
Tag class: FormLabelTag
 

[ Syntax ]

Standard Syntax
<forms:label
[ accesskey = "String" ]
[ align = "{left | right | center}" ]
[ filter = "Boolean" ]
[ imageref = "String" ]
[ label = "String" ]
[ locale = "String" ]
[ maxlength = "Integer" ]
[ nowrap = "Boolean" ]
[ 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" ]
[ prefix = "String" ]
[ style = "String" ]
[ styleClass = "String" ]
[ styleId = "String" ]
[ suffix = "String" ]
[ tooltip = "String" ]
[ width = "String" ]
>
...Body Content...

</forms:label>
 

[ Attribute ]

AttributTypBeschreibungPflichtRTExp
accesskeyString Der Tastatur-Shortcut (darf nur ein Zeichen sein), mit dem der Browser den Fokus auf ein Eingabeelement übertragen kann.  
alignAlignmentType Gibt die horizontale Ausrichtung in der Formularelement Zelle an
  • left = linksbündige Ausrichtung
  • right = rechtsbündige Ausrichtung
  • center = zentrierte Ausrichtung
 
filterBoolean 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 "&lt;" 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.
 
imagerefString Verweis auf ein Element der ImageMap. Das Image wird vor dem Label gezeichnet.  
labelString Das Label des Formularelementes.  
localeString Weist das Kontrollelement an alle angegebenen Zeichenkettenliterale als Schlüssel für Textressourcen zu interpretieren.

Die folgenden Werte sind möglich:

  • "true" Die Lokalisierung ist aktiv und es wird die von Struts vergebene Ländereinstellung des angemeldenten Benutzers verwendet (wie in der HTTP Session unter dem Schlüssel org.apache.struts.action.LOCALE abgelegt).
  • "false" Die Lokalisierung ist nicht aktiviert. Alle Zeichenkettenliterale werden wie angegeben in die HTML Seite geschrieben.
  • ISO Code Die Lokalisierung ist aktiv und es wird die angegebene Sprache verwendet.

Bei aktivierter Lokalisierung werden die angegebenen Schlüssel von dem registrierten FrameworkAdapter (eine Interface Klasse) mit Hilfe der überschreibbaren localizeKey() Methode übersetzt. Der mitgelieferte StrutsFrameworkAdapter verwendet die in der struts-config.xml registrierten Message Resource Bundles für die Übersetzung des Ressourcen Schlüssels.

Zeichenketten die mit einem "#"-Zeichen beginnen werden grundsätzlich nicht lokalisiert (Das "#"-Zeichen wird jedoch abgeschnitten).

Alle Zeichenketten die von einem DataModel zurückgeliefert werden, sind ebenfalls von dem Lokalisierungsmechanismus ausgeschlossen, da dies in den Aufgabenbereich der Applikation fällt.

 
maxlengthInteger Gibt die maximale Zeichenzahl für die Dateneingabe an.  
nowrapBoolean Gibt an ob das Label umgebrochen werden darf  
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

 
prefixString Gibt ein potionales Präfix (als HTML Literal) an, welches allen Labels des Formulars vorangestellt wird. Mit der Angabe dieses Attributs wird die Einstellung auf Formular Ebene überschrieben.

Anmerkung: Eine HTML Zeichenkette, welche unverändert ausgegeben wird

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

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

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

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

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

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

 
suffixString Gibt ein potionales Suffix (als HTML Literal) an, welches an alle Labels des Formulars angehängt wird. Mit der Angabe dieses Attributs wird die Einstellung auf Formular Ebene überschrieben.

Anmerkung: Eine HTML Zeichenkette, welche unverändert ausgegeben wird

 
tooltipString Ein Kurzer Hinweistext, welcher angezeigt wird, wenn der Anwender den Mauszeiger über das Element bewegt.  
widthString Setzt die Breite des Kontrollelmentes. Die Breite kann absolut oder prozentual angegeben werden.

Siehe HTML-Dokumentation

 

[ Beispiel ]

Erzeugt ein Formularelement mit einem Label


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

<forms:form type="edit" caption="Userprofile - Edit" formid="frmEdit" width="550">

   <forms:row>
      <forms:text  property="p1"  size="15"  maxlength="20"  required="true" style="background-color: yellow; letter-spacing: 2px;">
         <forms:label
            locale="false"
            label="Account-number"
            style="color: gray; letter-spacing: 2px;"
            width="85"/>
      </forms:text>

      <forms:checkbox  property="p2"  description="Master"/>
   </forms:row>

   <forms:text  property="p3"  size="35"  maxlength="30"  required="true">
      <forms:label
         locale="false"
         label="Description"
         style="text-decoration: line-through;"/>
   </forms:text>
</forms:form>

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