Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin
Note

Please make sure you have read the Tag Syntax document and understand how tag attribute syntax works.

Description

Wiki Markup
{snippet:id=javadoc|javadoc=true|url=org.apache.struts2.components.Form}

Parameters

Wiki Markup
{snippet:id=tagattributes|javadoc=false|url=struts2-tags/form.html}

Examples

Wiki Markup
{snippet:id=example|lang=xml|javadoc=true|url=org.apache.struts2.components.Form}

Validation

There are two flavours Client Side Validation, depending on the theme you are using (xhtml, ajax, etc). If you are using the xhtml theme or css_xhtml theme, pure client side validation will be used. If you are using the ajax theme, a special AJAX-based validation will take place. Read the Client Side Validation docs for more information

Talk generally about the form, behaviors, etc. Mention theme-specific notes as well.

Attribute

Type

Required

Default

Theme

Description

action

String

Yes

N/A

simple

...

namespace

String

No

The current namespace

simple

...

validate

boolean

No

false

xhtml

...

form

Attribute

Type

Required

Default

Description

id

string

FALSE

action attribute

 

name

string

FALSE

action attribute

 

action

string

FALSE

 

 

target

string

FALSE

 

 

enctype

string

FALSE

 

 

method

string

FALSE

 

 

namespace

string

FALSE

global namespace: """

 

onsubmit

string

FALSE

 

 

validate

boolean

FALSE

 

 

name

string

TRUE

 

 

value

string

FALSE

 

 

required

boolean

FALSE

 

 

disabled

boolean

FALSE

 

 

theme

string

FALSE

 

 

template

string

FALSE

 

 

cssClass

string

FALSE

 

 

cssStyle

string

FALSE

 

 

label

string

FALSE

 

 

labelposition

string

FALSE

 

 

tabindex

string

FALSE

 

 

onclick

string

FALSE

 

 

ondblclick

string

FALSE

 

 

onmousedown

string

FALSE

 

 

onmouseup

string

FALSE

 

 

onmouseover

string

FALSE

 

 

onmousemove

string

FALSE

 

 

onmouseout

string

FALSE

 

 

onfocus

string

FALSE

 

 

onblur

string

FALSE

 

 

onkeypress

string

FALSE

 

 

onkeydown

string

FALSE

 

 

onselect

string

FALSE

 

 

onchange

string

FALSE

 

 

The remote form allows the form to be submitted without the page being refreshed. The results from the form can be inserted into any HTML element on the page.

Validation

There are two flavours of validation
1. Normal request/response process - please see Validation.
1. AJAX-based validation, which is performed when the user moves between fields - please see Remote Form Validation

Asynchronous Form Processing (AJAX)

To ajax enable the form, the form tag must be used specifying a theme="ajax". Additionally, the submit tag must be used to provide the button that will submit the form.