| 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.Submit} |
| Note |
|---|
To use method attribute (to use multiple submit buttons which direct to different action methods) you must set struts.enable.DynamicMethodInvocation to true but this can lead to security vulnerability - use with care! Instead you can try to use Multiple Submit Buttons solution. |
| Note |
|---|
This tag works with all themes, but has special importance when combined with the form tag in the ajax theme. Please read up on the ajax theme for more information. |
Parameters
| Wiki Markup |
|---|
{snippet:id=tagattributes|javadoc=false|url=struts2-tags/submit.html} |
The ajax-specific attributes of ww:submit are:
Attribute | Type | Required | Default | Description |
|---|---|---|---|---|
resultDivId | string | TRUE |
| The id of the HTML element to place the result (this can the the form's id or any id on the page |
notifyTopics | string | FALSE |
| Topic names to post an event to after the form has been submitted |
onLoadJS | string | FALSE |
| Javascript code that will be executed after the form has been submitted. The format is onLoadJS='yourMethodName(data,type)'. NOTE: the words data and type must be left like that if you want the event type and the returned data. |
The remote form has three basic modes of use, using the resultDivId, the notifyTopics, or the onLoadJS. You can mix and match any combination of them to get your desired result. All of these examples are contained in the Ajax example webapp. Lets go through some scenarios to see how you might use it:
...
| Code Block |
|---|
Remote form replacing another div:
<div id='two' style="border: 1px solid yellow;">Initial content</div>
<ww:form
id='theForm2'
cssStyle="border: 1px solid green;"
action='/AjaxRemoteForm.action'
method='post'
theme="ajax">
<input type='text' name='data' value='WebWork User'>
<ww:submit value="GO2" theme="ajax" resultDivId="two"/>
</ww:form>
|
...
| Code Block |
|---|
<ww:form id="frm1" action="newPersonWithXMLResult" theme="ajax" >
<ww:textfield label="'Name'" name="'person.name'" value="person.name" size="20" required="true" />
<ww:submit id="submitBtn" value="Save" theme="ajax" cssClass="primary" notifyTopics="personUpdated, systemWorking" />
</ww:form>
<ww:div href="/listPeople.action" theme="ajax" errorText="error opps"
loadingText="loading..." id="cart-body" >
<ww:action namespace="" name="listPeople" executeResult="true" />
</ww:div>
|
...