|
Um die Formular-Tags auf einer JSP Seite einzusetzen, muss am Anfang der Seite die entsprechende Tag Library deklariert werden. Anschließend können die Formularelemente mit dem Präfix <forms:tagname /> verwendet werden. [Zudem muss die Aufnahme der Tag Bibliothek im Deployment-Deskriptor, der WEB-INF/web.xml Datei, erfolgen].
Unser Formular enthält neben Eingabefeldern und Auswahlboxen auch einen Abschnitt zur Gruppierung von Informationen und eine Button-Leiste. Die benötigten Elemente werden über die folgenden Tags definiert:
| Tag |
Beschreibung |
| <forms:form/> |
Definiert das Formular. Es wird die Überschrift festgelegt |
| <forms:plaintext/> |
Dient zur Ausgabe von Text. |
| <forms:text/> |
Erzeugt ein Eingabefeld. Zur Kennzeichnung von Pflichtfeldern dient das Required-Attribut. |
| <forms:select/> |
Definiert eine Auswahlbox |
| <forms:options/> |
Definiert eine Optionsliste für eine Auswahlbox |
| <forms:section/> |
Definiert und zeichnet einen Absatz |
| <forms:buttonsection/> |
Definiert eine Button-Leiste und legt einen Default-Button fest |
| <forms:button/> |
Definiert und zeichnet einen Absatz |
| <forms:message/> |
Zeichnet einen Meldungsdialog. Über das Attribut severity="error" wird der Dialog als Fehlerdialog klassifiziert. |
<%@ taglib uri="/WEB-INF/struts-html.tld" prefix="html" %>
<%@ taglib uri="/WEB-INF/tlds/cc-forms.tld" prefix="forms" %>
<%@ taglib uri="/WEB-INF/tlds/cc-controls.tld" prefix="ctrl" %>
<forms:message caption="Error" severity="error"/>
<html:form action="/sample101/userEdit">
<forms:form type="edit" caption="User - Edit" formid="frmEdit">
<forms:plaintext
label="User-Id"
property="userId"/>
<forms:text
label="First-Name"
property="lastName"
size="45"
required="true"/>
<forms:text
label="Last-Name"
property="firstName"
size="45"
required="true"/>
<forms:select
label="Role"
property="rolekey">
<ctrl:options property="roleOptions"/>
</forms:select>
<forms:text
label="eMail"
property="email"
size="45"/>
<forms:text
label="Phone"
property="phone"
size="25" />
<forms:section title="Address">
<forms:text
label="Street"
property="street"
size="45"/>
<forms:text
label="Number"
property="streetnumber"
size="5"/>
<forms:text
label="ZipCode"
property="zipcode"
size="5"/>
<forms:text
label="City"
property="city"
size="25"/>
<forms:select
label="Country"
property="countrycode">
<ctrl:options
property="countryOptions"
labelProperty="country"/>
</forms:select>
</forms:section>
<forms:buttonsection default="btnSave">
<forms:button name="btnBack"
src="btnBack1.gif"/>
<forms:button name="btnSave"
src="btnSave1.gif"/>
</forms:buttonsection>
</forms:form>
</html:form>
Das <form>-Tag ist in unserem Beispiel in ein Stuts -Tag eingebettet. Es erhält damit über die angegebene Action (/sample101/userEdit) den Zugriff auf die Form-Bean, welche die Anzeigedaten bereitstellt. Das <form>-Tag kann auch alleine ohne Struts <html:form> Tag verwendet werden, dann muss jedoch zusätzlich das action-Attribut angegeben werden.
Alle Tags der Common Controls Bibliothek arbeiten bei Bedarf im Verbund mit den Struts Tags!
zurück |
weiter zu Schritt 5 
|
buy online
ListControl
Druckversion