The submit tag is used together with the form tag to provide asynchronous form submissions.
Note |
---|
Be sure to setup the page containing this tag to be Configured for AJAX |
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. |
preInvokeJS | string | FALSE |
| A javascript snippet that will be invoked prior to the submission of the form. If provided must return true or false. True indicates to continue submiting the form... false says do not submit the form. Possible uses are confirm dialogs and running code to manipulate form contents. |
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>
|
...
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} |