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.
Attributes
To ajax enable the form, the ww:form component must be used, specifying a theme="ajax". Additionally, the ww:submit component must be used.