You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@struts.apache.org by lu...@apache.org on 2020/01/28 07:32:53 UTC
[struts-site] branch master updated: Drops outdated document
This is an automated email from the ASF dual-hosted git repository.
lukaszlenart pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/struts-site.git
The following commit(s) were added to refs/heads/master by this push:
new 5af7d39 Drops outdated document
5af7d39 is described below
commit 5af7d390921e85e2a2be19aecfae99ee7a754c05
Author: Lukasz Lenart <lu...@apache.org>
AuthorDate: Tue Jan 28 08:32:45 2020 +0100
Drops outdated document
---
source/tag-developers/ajax-common-header.md | 34065 --------------------------
1 file changed, 34065 deletions(-)
diff --git a/source/tag-developers/ajax-common-header.md b/source/tag-developers/ajax-common-header.md
deleted file mode 100644
index e4194f4..0000000
--- a/source/tag-developers/ajax-common-header.md
+++ /dev/null
@@ -1,34065 +0,0 @@
----
-layout: default
-title: Tag Developers Guide
----
-
-# ajax common header
-
-To use this tag:
-
-- Add: `<%@ taglib prefix="sx" uri="/struts-dojo-tags" %>` to your page.
-- The [head](head-tag.html) tag must be included on the page, which can be configured for performance or debugging purposes.
-- If the `parseContent` parameter for the [head](head-tag.html) tag is false (it is false by default), then the **id** tag is required.
-
-For more examples see [Ajax and JavaScript Recipes](ajax-and-javascript-recipes.html)
-
-
-#####autocompleter##### {#PAGE_46753}
-
-__Description__
-
-
-
-{% comment %}start snippet id=javadoc|javadoc=true|url=struts2/plugins/dojo/src/main/java/org/apache/struts2/dojo/components/Autocompleter.java {% endcomment %}
-<p> <p>The autocomplete tag is a combobox that can autocomplete text entered on the input box. If an action
- is used to populate the autocompleter, the output of the action must be a well formed JSON string. </p>
- <p>The autocompleter follows this rule to find its datasource:<p>
- <p>1. If the response is an array, assume that it contains 2-dimension array elements, like:
- <pre>
- [
- ["Alabama", "AL"],
- ["Alaska", "AK"]
- ]
- </pre>
- <p>2. If a value is specified in the "dataFieldName" attribute, and the response has a field with that
- name, assume that's the datasource, which can be an array of 2-dimension array elements, or a map,
- like (assuming dataFieldName="state"):</p>
- <pre>
- {
- "state" : [
- ["Alabama","AL"],
- ["Alaska","AK"]
- ]
- }
- or
- {
- "state" : {
- "Alabama" : "AL",
- "Alaska" : "AK"
- }
- }
- </pre>
- </pre>
- <p>3. If there is a field that starts with the value specified on the "name" attribute, assume
- that's the datasource, like (assuming name="state"):</p>
- <pre>
- {
- "states" : [
- ["Alabama","AL"],
- ["Alaska","AK"]
- ]
- }
- </pre>
- <p>4. Use first array that is found, like:<p>
- <pre>
- {
- "anything" : [
- ["Alabama", "AL"],
- ["Alaska", "AK"]
- ]
- }
- <p>5. If the response is a map, use it (recommended as it is the easiest one to generate):
- <pre>
- {
- "Alabama" : "AL",
- "Alaska" : "AK"
- }
- </pre>
-</p>
-{% comment %}end snippet id=javadoc|javadoc=true|url=struts2/plugins/dojo/src/main/java/org/apache/struts2/dojo/components/Autocompleter.java {% endcomment %}
-
-__Parameters__
-
-
-
-{% comment %}start snippet id=tagattributes|javadoc=false|url=struts2-tags/ajax/autocompleter.html {% endcomment %}
-<p> <table width="100%">
-
- <tr>
-
- <td colspan="6"><h4>Dynamic Attributes Allowed:</h4> false</td>
-
- </tr>
-
- <tr>
-
- <td colspan="6"> </td>
-
- </tr>
-
- <tr>
-
- <th align="left" valign="top"><h4>Name</h4></th>
-
- <th align="left" valign="top"><h4>Required</h4></th>
-
- <th align="left" valign="top"><h4>Default</h4></th>
-
- <th align="left" valign="top"><h4>Evaluated</h4></th>
-
- <th align="left" valign="top"><h4>Type</h4></th>
-
- <th align="left" valign="top"><h4>Description</h4></th>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">accesskey</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html accesskey attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">afterNotifyTopics</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Comma delimmited list of topics that will published after the request(if the request succeeds)</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">autoComplete</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">Boolean</td>
-
- <td align="left" valign="top">Whether autocompleter should make suggestion on the textbox</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">beforeNotifyTopics</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Comma delimmited list of topics that will published before the request</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">cssClass</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The css class to use for element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">cssErrorClass</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The css error class to use for element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">cssErrorStyle</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The css error style definitions for element to use</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">cssStyle</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The css style to use for element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">dataFieldName</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">Value specified in 'name'</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Name of the field in the returned JSON object that contains the data array</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">delay</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">100</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">Integer</td>
-
- <td align="left" valign="top">Delay before making the search</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">disabled</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">Boolean</td>
-
- <td align="left" valign="top">Enable or disable autocompleter</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">dropdownHeight</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">120</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">Integer</td>
-
- <td align="left" valign="top">Dropdown's height in pixels</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">dropdownWidth</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">same as textbox</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">Integer</td>
-
- <td align="left" valign="top">Dropdown's width</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">emptyOption</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Decide if an empty option is to be inserted. Default false.</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">errorNotifyTopics</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Comma delimmited list of topics that will published after the request(if the request fails)</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">errorPosition</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Define error position of form element (top|bottom)</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">forceValidOption</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">Boolean</td>
-
- <td align="left" valign="top">Force selection to be one of the options</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">formFilter</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Function name used to filter the fields of the form</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">formId</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Form id whose fields will be serialized and passed as parameters</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">headerKey</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the header key for the header option.</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">headerValue</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the header value for the header option.</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">href</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The URL used to load the options</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">iconPath</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Path to icon used for the dropdown</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">id</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The id to use for the element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">indicator</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Id of element that will be shown while request is made</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">javascriptTooltip</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">Boolean</td>
-
- <td align="left" valign="top">Use JavaScript to generate tooltips</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">key</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the key (name, value, label) for this particular component</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">keyName</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Name of the field to which the selected key will be assigned</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">keyValue</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Initial key value</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">label</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Label expression used for rendering an element specific label</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">labelSeparator</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">:</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">String that will be appended to the label</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">labelposition</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Define label position of form element (top/left)</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">list</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Iteratable source to populate from.</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">listKey</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the key used to retrive the option key.</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">listValue</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the value used to retrive the option value.</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">listenTopics</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Topic that will trigger a reload</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">loadMinimumCount</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">3</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">Integer</td>
-
- <td align="left" valign="top">Minimum number of characters that will force the content to be loaded</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">loadOnTextChange</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">true</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">Boolean</td>
-
- <td align="left" valign="top">Options will be reloaded everytime a character is typed on the textbox</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">maxLength</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">Integer</td>
-
- <td align="left" valign="top">Deprecated. Use maxlength instead.</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">maxlength</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">Integer</td>
-
- <td align="left" valign="top">HTML maxlength attribute</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">name</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The name to set for element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">notifyTopics</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Topics that will be published when content is reloaded</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onblur</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top"> Set the html onblur attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onchange</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onchange attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onclick</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onclick attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">ondblclick</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html ondblclick attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onfocus</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onfocus attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onkeydown</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onkeydown attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onkeypress</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onkeypress attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onkeyup</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onkeyup attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onmousedown</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onmousedown attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onmousemove</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onmousemove attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onmouseout</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onmouseout attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onmouseover</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onmouseover attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onmouseup</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onmouseup attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onselect</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onselect attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">preload</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">true</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">Boolean</td>
-
- <td align="left" valign="top">Load options when page is loaded</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">readonly</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">Boolean</td>
-
- <td align="left" valign="top">Whether the input is readonly</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">requiredLabel</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">Boolean</td>
-
- <td align="left" valign="top">If set to true, the rendered element will indicate that input is required</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">requiredPosition</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Define required position of required form element (left|right)</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">resultsLimit</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">30</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">Integer</td>
-
- <td align="left" valign="top">Limit how many results are shown as autocompletion options, set to -1 for unlimited results</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">searchType</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">stringstart</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">how the search must be performed, options are: 'startstring', 'startword' and 'substring'</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">showDownArrow</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">true</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">Boolean</td>
-
- <td align="left" valign="top">Show or hide the down arrow button</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">size</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">Integer</td>
-
- <td align="left" valign="top">HTML size attribute</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">style</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The css style definitions for element to use - it's an alias of cssStyle attribute.</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">tabindex</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html tabindex attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">template</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The template (other than default) to use for rendering the element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">templateCssPath</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Template css path</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">templateDir</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The template directory.</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">title</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html title attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">tooltip</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the tooltip of this particular component</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">tooltipConfig</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Deprecated. Use individual tooltip configuration attributes instead.</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">tooltipCssClass</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">StrutsTTClassic</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">CSS class applied to JavaScrip tooltips</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">tooltipDelay</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">Classic</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Delay in milliseconds, before showing JavaScript tooltips </td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">tooltipIconPath</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Icon path used for image that will have the tooltip</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">transport</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">XMLHTTPTransport</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Transport used by Dojo to make the request</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">type</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">text</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Specifies the html5 type element to display. e.g. text, email, url</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">value</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Preset the value of input element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">valueNotifyTopics</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Comma delimmited list of topics that will published when a value is selected</td>
-
- </tr>
-
- </table>
-
-</p>
-{% comment %}end snippet id=tagattributes|javadoc=false|url=struts2-tags/ajax/autocompleter.html {% endcomment %}
-
-__Examples__
-
-Get list from an action:
-
-
-{% comment %}start snippet id=example1|lang=xml|javadoc=true|url=struts2/plugins/dojo/src/main/java/org/apache/struts2/dojo/components/Autocompleter.java {% endcomment %}
-
-```xml
- <sx:autocompleter name="autocompleter1" href="%{jsonList}"/>
-
-```
-
-{% comment %}end snippet id=example1|lang=xml|javadoc=true|url=struts2/plugins/dojo/src/main/java/org/apache/struts2/dojo/components/Autocompleter.java {% endcomment %}
-
-Uses a list:
-
-
-{% comment %}start snippet id=example2|lang=xml|javadoc=true|url=struts2/plugins/dojo/src/main/java/org/apache/struts2/dojo/components/Autocompleter.java {% endcomment %}
-
-```xml
- <s:autocompleter name="test" list="{'apple','banana','grape','pear'}" autoComplete="false"/>
-
-```
-
-{% comment %}end snippet id=example2|lang=xml|javadoc=true|url=struts2/plugins/dojo/src/main/java/org/apache/struts2/dojo/components/Autocompleter.java {% endcomment %}
-
-Autocompleter that reloads its content everytime the text changes (and the length of the text is greater than 3):
-
-
-{% comment %}start snippet id=example3|lang=xml|javadoc=true|url=struts2/plugins/dojo/src/main/java/org/apache/struts2/dojo/components/Autocompleter.java {% endcomment %}
-
-```xml
- <sx:autocompleter name="mvc" href="%{jsonList}" loadOnTextChange="true" loadMinimumCount="3"/>
-
- The text entered on the autocompleter is passed as a parameter to the url specified in "href", like (text is "struts"):
-
- http://host/example/myaction.do?mvc=struts
-
-```
-
-{% comment %}end snippet id=example3|lang=xml|javadoc=true|url=struts2/plugins/dojo/src/main/java/org/apache/struts2/dojo/components/Autocompleter.java {% endcomment %}
-
-Linking two autocompleters:
-
-
-{% comment %}start snippet id=example4|lang=xml|javadoc=true|url=struts2/plugins/dojo/src/main/java/org/apache/struts2/dojo/components/Autocompleter.java {% endcomment %}
-
-```xml
- <form id="selectForm">
- <sx:autocompleter name="select" list="{'fruits','colors'}" valueNotifyTopics="/changed" />
- </form>
- <sx:autocompleter href="%{jsonList}" formId="selectForm" listenTopics="/changed"/>
-
-```
-
-{% comment %}end snippet id=example4|lang=xml|javadoc=true|url=struts2/plugins/dojo/src/main/java/org/apache/struts2/dojo/components/Autocompleter.java {% endcomment %}
-
-Set/Get selected values using JavaScript:
-
-
-{% comment %}start snippet id=example5|lang=xml|javadoc=true|url=struts2/plugins/dojo/src/main/java/org/apache/struts2/dojo/components/Autocompleter.java {% endcomment %}
-
-```xml
- <sx:autocompleter href="%{jsonList}" id="auto"/>
- <script type="text/javascript">
- function getValues() {
- var autoCompleter = dojo.widget.byId("auto");
-
- //key (in the states example above, "AL")
- var key = autoCompleter.getSelectedKey();
- alert(key);
-
- //value (in the states example above, "Alabama")
- var value = autoCompleter.getSelectedValue();
- alert(value);
-
- //text currently on the textbox (anything the user typed)
- var text = autoCompleter.getText();
- alert(text);
- }
-
- function setValues() {
- var autoCompleter = dojo.widget.byId("auto");
-
- //key (key will be set to "AL" and value to "Alabama")
- autoCompleter.setSelectedKey("AL");
-
- //value (key will be set to "AL" and value to "Alabama")
- autoCompleter.setAllValues("AL", "Alabama");
- }
- </script>
-
-```
-
-{% comment %}end snippet id=example5|lang=xml|javadoc=true|url=struts2/plugins/dojo/src/main/java/org/apache/struts2/dojo/components/Autocompleter.java {% endcomment %}
-
-Using beforeNotifyTopics:
-
-
-{% comment %}start snippet id=example6|lang=xml|javadoc=true|url=struts2/plugins/dojo/src/main/java/org/apache/struts2/dojo/components/Autocompleter.java {% endcomment %}
-
-```xml
- <script type="text/javascript">
- dojo.event.topic.subscribe("/before", function(event, widget){
- alert('inside a topic event. before request');
- //event: set event.cancel = true, to cancel request
- //widget: widget that published the topic
- });
- </script>
-
- <sx:autocompleter beforeNotifyTopics="/before" href="%{#ajaxTest} />
-
-```
-
-{% comment %}end snippet id=example6|lang=xml|javadoc=true|url=struts2/plugins/dojo/src/main/java/org/apache/struts2/dojo/components/Autocompleter.java {% endcomment %}
-
-Using errorNotifyTopics:
-
-
-{% comment %}start snippet id=example7|lang=xml|javadoc=true|url=struts2/plugins/dojo/src/main/java/org/apache/struts2/dojo/components/Autocompleter.java {% endcomment %}
-
-```xml
- <script type="text/javascript">
- dojo.event.topic.subscribe("/after", function(data, request, widget){
- alert('inside a topic event. after request');
- //data : JavaScript object from parsing response
- //request: XMLHttpRequest object
- //widget: widget that published the topic
- });
- </script>
-
- <sx:autocompleter afterNotifyTopics="/after" href="%{#ajaxTest}" />
-
-```
-
-{% comment %}end snippet id=example7|lang=xml|javadoc=true|url=struts2/plugins/dojo/src/main/java/org/apache/struts2/dojo/components/Autocompleter.java {% endcomment %}
-
-Using errorNotifyTopics:
-
-
-{% comment %}start snippet id=example8|javadoc=true|url=struts2/plugins/dojo/src/main/java/org/apache/struts2/dojo/components/Autocompleter.java {% endcomment %}
-<p> <script type="text/javascript">
- dojo.event.topic.subscribe("/error", function(error, request, widget){
- alert('inside a topic event. on error');
- //error : error object (error.message has the error message)
- //request: XMLHttpRequest object
- //widget: widget that published the topic
- });
- </script>
-
- <sx:autocompleter errorNotifyTopics="/error" href="%{#ajaxTest}" />
-</p>
-{% comment %}end snippet id=example8|javadoc=true|url=struts2/plugins/dojo/src/main/java/org/apache/struts2/dojo/components/Autocompleter.java {% endcomment %}
-
-Using valueNotifyTopics:
-
-
-{% comment %}start snippet id=example9|javadoc=true|url=struts2/plugins/dojo/src/main/java/org/apache/struts2/dojo/components/Autocompleter.java {% endcomment %}
-<p> <script type="text/javascript">
- dojo.event.topic.subscribe("/value", function(value, key, text, widget){
- alert('inside a topic event. after value changed');
- //value : selected value (like "Florida" in example above)
- //key: selected key (like "FL" in example above)
- //text: text typed into textbox
- //widget: widget that published the topic
- });
- </script>
-
- <sx:autocompleter valueNotifyTopics="/value" href="%{#ajaxTest}" />
-</p>
-{% comment %}end snippet id=example9|javadoc=true|url=struts2/plugins/dojo/src/main/java/org/apache/struts2/dojo/components/Autocompleter.java {% endcomment %}
-
-__Caveats__
-
-+ The service that is producing the HTTP Response with JSON response to the Autocompleter tag must set the HTTP Header Response Content-Type to `text/json`. JSON has its own MIME type, which this tag expects.
-
-+ Since 2.0.9, there is a change in the value:key order. Now, the value **must** come before the key.
-
-#####bind##### {#PAGE_66798}
-
-__Description__
-
-
-
-{% comment %}start snippet id=javadoc|javadoc=true|url=struts2/plugins/dojo/src/main/java/org/apache/struts2/dojo/components/Bind.java {% endcomment %}
-<p> <p>
- This tag will generate event listeners for multiple events on multiple sources,
- making an asynchronous request to the specified href, and updating multiple targets.
- </p>
-</p>
-{% comment %}end snippet id=javadoc|javadoc=true|url=struts2/plugins/dojo/src/main/java/org/apache/struts2/dojo/components/Bind.java {% endcomment %}
-
-There's a bug in IE6/IE7 which makes impossible to use the target's attribute with a parent Div, because such Div's content's are overwritten with the tag's _loadingText_ . Resulting in an "undefined" message in the content's, instead of the result of the request.
-
-One possible alternative is to set _showLoadingText="false"_ and set the indicator attribute to an element showing the desired loading text or image (outside the div).
-
-
-```jsp
-
-<img id="loadingImage" src="images/loadingAnimation.gif" style="display:none"/>
-<s:div id="parentDiv">
- <s:form action="actionName">
- <s:submit id="btn" />
- <sx:bind sources="btn" events="onclick" targets="parentDiv" showLoadingText="false" indicator="loadingImage"/>
- </s:form>
-</s:div>
-
-```
-
-__Parameters__
-
-
-
-{% comment %}start snippet id=tagattributes|javadoc=false|url=struts2-tags/ajax/bind.html {% endcomment %}
-<p> <table width="100%">
-
- <tr>
-
- <td colspan="6"><h4>Dynamic Attributes Allowed:</h4> false</td>
-
- </tr>
-
- <tr>
-
- <td colspan="6"> </td>
-
- </tr>
-
- <tr>
-
- <th align="left" valign="top"><h4>Name</h4></th>
-
- <th align="left" valign="top"><h4>Required</h4></th>
-
- <th align="left" valign="top"><h4>Default</h4></th>
-
- <th align="left" valign="top"><h4>Evaluated</h4></th>
-
- <th align="left" valign="top"><h4>Type</h4></th>
-
- <th align="left" valign="top"><h4>Description</h4></th>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">afterNotifyTopics</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Comma delimmited list of topics that will published after the request(if the request succeeds)</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">ajaxAfterValidation</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">Boolean</td>
-
- <td align="left" valign="top">Make an asynchronous request if validation succeeds. Only valid is 'validate' is 'true'</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">beforeNotifyTopics</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Comma delimmited list of topics that will published before the request</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">errorNotifyTopics</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Comma delimmited list of topics that will published after the request(if the request fails)</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">errorText</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The text to display to the user if the is an error fetching the content</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">events</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Comma delimited list of event names to attach to</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">executeScripts</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">Boolean</td>
-
- <td align="left" valign="top">Javascript code in the fetched content will be executed</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">formFilter</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Function name used to filter the fields of the form.</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">formId</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Form id whose fields will be serialized and passed as parameters</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">handler</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Javascript function name that will make the request</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">highlightColor</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">none</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Color used to perform a highlight effect on the elements specified in the 'targets' attribute</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">highlightDuration</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">2000</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">Integer</td>
-
- <td align="left" valign="top">Duration of highlight effect in milliseconds. Only valid if 'highlightColor' attribute is set</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">href</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The URL to call to obtain the content. Note: If used with ajax context, the value must be set as an url tag value.</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">id</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The id to use for the element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">indicator</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Id of element that will be shown while making request</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">listenTopics</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Topic that will trigger the remote call</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">loadingText</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">Loading...</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Text to be shown while content is being fetched</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">notifyTopics</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Comma delimmited list of topics that will published before and after the request, and on errors</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">separateScripts</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">true</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Run scripts in a separate scope, unique for each tag</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">showErrorTransportText</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">true</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">Boolean</td>
-
- <td align="left" valign="top">Set whether errors will be shown or not</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">showLoadingText</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">Boolean</td>
-
- <td align="left" valign="top">Show loading text on targets</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">sources</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Comma delimited list of ids of the elements to attach to</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">targets</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Comma delimited list of ids of the elements whose content will be updated</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">transport</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">XMLHTTPTransport</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Transport used by Dojo to make the request</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">validate</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">Boolean</td>
-
- <td align="left" valign="top">Perform Ajax validation. 'ajaxValidation' interceptor must be applied to action</td>
-
- </tr>
-
- </table>
-
-</p>
-{% comment %}end snippet id=tagattributes|javadoc=false|url=struts2-tags/ajax/bind.html {% endcomment %}
-
-__Examples__
-
-Without attaching to an event, listening to a topic (used to make an Ajax call):
-
-
-{% comment %}start snippet id=example0|lang=xml|javadoc=true|url=struts2/plugins/dojo/src/main/java/org/apache/struts2/dojo/components/Bind.java {% endcomment %}
-
-```xml
- <sx:bind href="%{#ajaxTest}" listenTopics="/makecall"/>
- <s:submit onclick="dojo.event.topic.publish('/makecall')"/>
-
-```
-
-{% comment %}end snippet id=example0|lang=xml|javadoc=true|url=struts2/plugins/dojo/src/main/java/org/apache/struts2/dojo/components/Bind.java {% endcomment %}
-
-Attached to event 'onclick' on submit button:
-
-
-{% comment %}start snippet id=example1|lang=xml|javadoc=true|url=struts2/plugins/dojo/src/main/java/org/apache/struts2/dojo/components/Bind.java {% endcomment %}
-
-```xml
- <img id="indicator" src="${pageContext.request.contextPath}/images/indicator.gif" alt="Loading..." style="display:none"/>
- <sx:bind id="ex1" href="%{#ajaxTest}" sources="button" targets="div1" events="onclick" indicator="indicator" />
- <s:submit theme="simple" type="submit" value="submit" id="button"/>
-
-```
-
-{% comment %}end snippet id=example1|lang=xml|javadoc=true|url=struts2/plugins/dojo/src/main/java/org/apache/struts2/dojo/components/Bind.java {% endcomment %}
-
-Submit form:
-
-
-{% comment %}start snippet id=example2|lang=xml|javadoc=true|url=struts2/plugins/dojo/src/main/java/org/apache/struts2/dojo/components/Bind.java {% endcomment %}
-
-```xml
- <sx:bind id="ex3" href="%{#ajaxTest}" sources="chk1" targets="div1" events="onchange" formId="form1" />
- <form id="form1">
- <s:checkbox name="data" label="Hit me" id="chk1"/>
- </form>
-
-```
-
-{% comment %}end snippet id=example2|lang=xml|javadoc=true|url=struts2/plugins/dojo/src/main/java/org/apache/struts2/dojo/components/Bind.java {% endcomment %}
-
-Using beforeNotifyTopics:
-
-
-{% comment %}start snippet id=example4|lang=xml|javadoc=true|url=struts2/plugins/dojo/src/main/java/org/apache/struts2/dojo/components/Bind.java {% endcomment %}
-
-```xml
- <script type="text/javascript">
- dojo.event.topic.subscribe("/before", function(event, widget){
- alert('inside a topic event. before request');
- //event: set event.cancel = true, to cancel request
- //widget: widget that published the topic
- });
- </script>
-
- <input type="button" id="button">
- <sx:bind id="ex1" href="%{#ajaxTest}" beforeNotifyTopics="/before" sources="button" events="onclick"/>
-
-```
-
-{% comment %}end snippet id=example4|lang=xml|javadoc=true|url=struts2/plugins/dojo/src/main/java/org/apache/struts2/dojo/components/Bind.java {% endcomment %}
-
-Using afterNotifyTopics and highlight:
-
-
-{% comment %}start snippet id=example5|lang=xml|javadoc=true|url=struts2/plugins/dojo/src/main/java/org/apache/struts2/dojo/components/Bind.java {% endcomment %}
-
-```xml
- <script type="text/javascript">
- dojo.event.topic.subscribe("/after", function(data, request, widget){
- alert('inside a topic event. after request');
- //data : text returned from request(the html)
- //request: XMLHttpRequest object
- //widget: widget that published the topic
- });
- </script>
-
- <input type="button" id="button">
- <sx:bind id="ex1" href="%{#ajaxTest}" highlightColor="red" afterNotifyTopics="/after" sources="button" events="onclick"/>
-
-```
-
-{% comment %}end snippet id=example5|lang=xml|javadoc=true|url=struts2/plugins/dojo/src/main/java/org/apache/struts2/dojo/components/Bind.java {% endcomment %}
-
-Using errorNotifyTopics and indicator:
-
-
-{% comment %}start snippet id=example6|lang=xml|javadoc=true|url=struts2/plugins/dojo/src/main/java/org/apache/struts2/dojo/components/Bind.java {% endcomment %}
-
-```xml
- <script type="text/javascript">
- dojo.event.topic.subscribe("/error", function(error, request, widget){
- alert('inside a topic event. on error');
- //error : error object (error.message has the error message)
- //request: XMLHttpRequest object
- //widget: widget that published the topic
- });
- </script>
-
- <input type="button" id="button">
- <img id="ind1" src="${pageContext.request.contextPath}/images/indicator.gif" style="display:none"/>
- <sx:bind href="%{#ajaxTest}" indicator="ind1" errorNotifyTopics="/error" sources="button" events="onclick"/>
-
-```
-
-{% comment %}end snippet id=example6|lang=xml|javadoc=true|url=struts2/plugins/dojo/src/main/java/org/apache/struts2/dojo/components/Bind.java {% endcomment %}
-
-#####checkbox##### {#PAGE_14029}
-
-
-Please make sure you have read the [Tag Syntax](tag-syntax.html) document and understand how tag attribute syntax works.
-
-|
-
-__Description__
-
-
-
-{% comment %}start snippet id=javadoc|javadoc=true|url=org.apache.struts2.components.Checkbox {% endcomment %}
-<p> Renders an HTML input element of type checkbox, populated by the specified property from the ValueStack.
-</p>
-{% comment %}end snippet id=javadoc|javadoc=true|url=org.apache.struts2.components.Checkbox {% endcomment %}
-
-__Parameters__
-
-
-
-{% comment %}start snippet id=tagattributes|javadoc=false|url=struts2-tags/checkbox.html {% endcomment %}
-<p> <table width="100%">
-
- <tr>
-
- <td colspan="6"><h4>Dynamic Attributes Allowed:</h4> true</td>
-
- </tr>
-
- <tr>
-
- <td colspan="6"> </td>
-
- </tr>
-
- <tr>
-
- <th align="left" valign="top"><h4>Name</h4></th>
-
- <th align="left" valign="top"><h4>Required</h4></th>
-
- <th align="left" valign="top"><h4>Default</h4></th>
-
- <th align="left" valign="top"><h4>Evaluated</h4></th>
-
- <th align="left" valign="top"><h4>Type</h4></th>
-
- <th align="left" valign="top"><h4>Description</h4></th>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">accesskey</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html accesskey attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">class</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The css class to use for element - it's an alias of cssClass attribute.</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">cssClass</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The css class to use for element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">cssErrorClass</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The css error class to use for element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">cssErrorStyle</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The css error style definitions for element to use</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">cssStyle</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The css style definitions for element to use</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">disabled</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html disabled attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">errorPosition</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Define error position of form element (top|bottom)</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">fieldValue</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">true</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The actual HTML value attribute of the checkbox.</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">id</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">HTML id attribute</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">javascriptTooltip</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">Boolean</td>
-
- <td align="left" valign="top">Use JavaScript to generate tooltips</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">key</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the key (name, value, label) for this particular component</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">label</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Label expression used for rendering an element specific label</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">labelSeparator</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">:</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">String that will be appended to the label</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">labelposition</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Define label position of form element (top/left)</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">name</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The name to set for element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onblur</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top"> Set the html onblur attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onchange</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onchange attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onclick</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onclick attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">ondblclick</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html ondblclick attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onfocus</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onfocus attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onkeydown</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onkeydown attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onkeypress</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onkeypress attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onkeyup</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onkeyup attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onmousedown</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onmousedown attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onmousemove</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onmousemove attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onmouseout</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onmouseout attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onmouseover</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onmouseover attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onmouseup</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onmouseup attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onselect</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onselect attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">requiredLabel</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">Boolean</td>
-
- <td align="left" valign="top">If set to true, the rendered element will indicate that input is required</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">requiredPosition</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Define required position of required form element (left|right)</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">style</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The css style definitions for element to use - it's an alias of cssStyle attribute.</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">tabindex</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html tabindex attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">template</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The template (other than default) to use for rendering the element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">templateDir</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The template directory.</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">theme</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The theme (other than default) to use for rendering the element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">title</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html title attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">tooltip</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the tooltip of this particular component</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">tooltipConfig</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Deprecated. Use individual tooltip configuration attributes instead.</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">tooltipCssClass</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">StrutsTTClassic</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">CSS class applied to JavaScrip tooltips</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">tooltipDelay</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">Classic</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Delay in milliseconds, before showing JavaScript tooltips </td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">tooltipIconPath</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Icon path used for image that will have the tooltip</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">value</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Preset the value of input element.</td>
-
- </tr>
-
- </table>
-
-</p>
-{% comment %}end snippet id=tagattributes|javadoc=false|url=struts2-tags/checkbox.html {% endcomment %}
-
-__Examples__
-
-
-
-{% comment %}start snippet id=example|lang=xml|javadoc=true|url=org.apache.struts2.components.Checkbox {% endcomment %}
-
-```xml
- JSP:
- <s:checkbox label="checkbox test" name="checkboxField1" value="aBoolean" fieldValue="true"/>
-
- Velocity:
- #tag( Checkbox "label=checkbox test" "name=checkboxField1" "value=aBoolean" )
-
- Resulting HTML (simple template, aBoolean == true):
- <input type="checkbox" name="checkboxField1" value="true" checked="checked" />
-
-
-```
-
-{% comment %}end snippet id=example|lang=xml|javadoc=true|url=org.apache.struts2.components.Checkbox {% endcomment %}
-
-#####checkboxlist##### {#PAGE_13969}
-
-
-Please make sure you have read the [Tag Syntax](tag-syntax.html) document and understand how tag attribute syntax works.
-
-|
-
-
-{% comment %}start snippet id=javadoc|javadoc=true|url=org.apache.struts2.components.ListUIBean {% endcomment %}
-<p> <p>
- Note that the listkey and listvalue attribute will default to "key" and "value"
- respectively only when the list attribute is evaluated to a Map or its descendant.
- Everything else will result in listkey and listvalue to be null and not used.
- </p>
-</p>
-{% comment %}end snippet id=javadoc|javadoc=true|url=org.apache.struts2.components.ListUIBean {% endcomment %}
-
-__Description__
-
-
-
-{% comment %}start snippet id=javadoc|javadoc=true|url=org.apache.struts2.components.CheckboxList {% endcomment %}
-<p>
- Creates a series of checkboxes from a list. Setup is like <s:select /> or <s:radio />, but creates checkbox tags.
-
-</p>
-{% comment %}end snippet id=javadoc|javadoc=true|url=org.apache.struts2.components.CheckboxList {% endcomment %}
-
-__Parameters__
-
-
-
-{% comment %}start snippet id=tagattributes|javadoc=false|url=struts2-tags/checkboxlist.html {% endcomment %}
-<p> <table width="100%">
-
- <tr>
-
- <td colspan="6"><h4>Dynamic Attributes Allowed:</h4> true</td>
-
- </tr>
-
- <tr>
-
- <td colspan="6"> </td>
-
- </tr>
-
- <tr>
-
- <th align="left" valign="top"><h4>Name</h4></th>
-
- <th align="left" valign="top"><h4>Required</h4></th>
-
- <th align="left" valign="top"><h4>Default</h4></th>
-
- <th align="left" valign="top"><h4>Evaluated</h4></th>
-
- <th align="left" valign="top"><h4>Type</h4></th>
-
- <th align="left" valign="top"><h4>Description</h4></th>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">accesskey</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html accesskey attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">class</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The css class to use for element - it's an alias of cssClass attribute.</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">cssClass</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The css class to use for element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">cssErrorClass</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The css error class to use for element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">cssErrorStyle</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The css error style definitions for element to use</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">cssStyle</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The css style definitions for element to use</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">disabled</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html disabled attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">errorPosition</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Define error position of form element (top|bottom)</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">id</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">HTML id attribute</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">javascriptTooltip</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">Boolean</td>
-
- <td align="left" valign="top">Use JavaScript to generate tooltips</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">key</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the key (name, value, label) for this particular component</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">label</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Label expression used for rendering an element specific label</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">labelSeparator</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">:</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">String that will be appended to the label</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">labelposition</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Define label position of form element (top/left)</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">list</td>
-
- <td align="left" valign="top"><strong>true</strong></td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Iterable source to populate from. If the list is a Map (key, value), the Map key will become the option 'value' parameter and the Map value will become the option body.</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">listCssClass</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Property of list objects to get css class from</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">listCssStyle</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Property of list objects to get css style from</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">listKey</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Property of list objects to get field value from</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">listLabelKey</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Property of list objects to be used to lookup for localised version of field label</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">listTitle</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Property of list objects to get title from</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">listValue</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Property of list objects to get field content from</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">listValueKey</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Property of list objects to get field value label from</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">name</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The name to set for element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onblur</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top"> Set the html onblur attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onchange</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onchange attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onclick</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onclick attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">ondblclick</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html ondblclick attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onfocus</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onfocus attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onkeydown</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onkeydown attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onkeypress</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onkeypress attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onkeyup</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onkeyup attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onmousedown</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onmousedown attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onmousemove</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onmousemove attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onmouseout</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onmouseout attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onmouseover</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onmouseover attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onmouseup</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onmouseup attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onselect</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onselect attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">requiredLabel</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">Boolean</td>
-
- <td align="left" valign="top">If set to true, the rendered element will indicate that input is required</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">requiredPosition</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Define required position of required form element (left|right)</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">style</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The css style definitions for element to use - it's an alias of cssStyle attribute.</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">tabindex</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html tabindex attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">template</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The template (other than default) to use for rendering the element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">templateDir</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The template directory.</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">theme</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The theme (other than default) to use for rendering the element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">title</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html title attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">tooltip</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the tooltip of this particular component</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">tooltipConfig</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Deprecated. Use individual tooltip configuration attributes instead.</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">tooltipCssClass</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">StrutsTTClassic</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">CSS class applied to JavaScrip tooltips</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">tooltipDelay</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">Classic</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Delay in milliseconds, before showing JavaScript tooltips </td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">tooltipIconPath</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Icon path used for image that will have the tooltip</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">value</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Preset the value of input element.</td>
-
- </tr>
-
- </table>
-
-</p>
-{% comment %}end snippet id=tagattributes|javadoc=false|url=struts2-tags/checkboxlist.html {% endcomment %}
-
-__Examples__
-
-
-
-{% comment %}start snippet id=example|lang=xml|javadoc=true|url=org.apache.struts2.components.CheckboxList {% endcomment %}
-
-```xml
- <s:checkboxlist name="foo" list="bar"/>
-
-```
-
-{% comment %}end snippet id=example|lang=xml|javadoc=true|url=org.apache.struts2.components.CheckboxList {% endcomment %}
-
-#####combobox##### {#PAGE_14259}
-
-
-Please make sure you have read the [Tag Syntax](tag-syntax.html) document and understand how tag attribute syntax works.
-
-|
-
-__Description__
-
-
-
-{% comment %}start snippet id=javadoc|javadoc=true|url=org.apache.struts2.components.ComboBox {% endcomment %}
-<p> <p>
- The combo box is basically an HTML INPUT of type text and HTML SELECT grouped together to give you a combo box
- functionality. You can place text in the INPUT control by using the SELECT control or type it in directly in
- the text field.
- </p>
-
- <p>
- In this example, the SELECT will be populated from id=year attribute. Counter is itself an Iterator. It will
- span from first to last. The population is done via javascript, and requires that this tag be surrounded by a
- <form>.
- </p>
-
- <p>
- Note that unlike the <s:select/> tag, there is no ability to define the individual <option> tags' id attribute
- or content separately. Each of these is simply populated from the toString() method of the list item. Presumably
- this is because the select box isn't intended to actually submit useful data, but to assist the user in filling
- out the text field.
- </p>
-</p>
-{% comment %}end snippet id=javadoc|javadoc=true|url=org.apache.struts2.components.ComboBox {% endcomment %}
-
-__Parameters__
-
-
-
-{% comment %}start snippet id=tagattributes|javadoc=false|url=struts2-tags/combobox.html {% endcomment %}
-<p> <table width="100%">
-
- <tr>
-
- <td colspan="6"><h4>Dynamic Attributes Allowed:</h4> false</td>
-
- </tr>
-
- <tr>
-
- <td colspan="6"> </td>
-
- </tr>
-
- <tr>
-
- <th align="left" valign="top"><h4>Name</h4></th>
-
- <th align="left" valign="top"><h4>Required</h4></th>
-
- <th align="left" valign="top"><h4>Default</h4></th>
-
- <th align="left" valign="top"><h4>Evaluated</h4></th>
-
- <th align="left" valign="top"><h4>Type</h4></th>
-
- <th align="left" valign="top"><h4>Description</h4></th>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">accesskey</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html accesskey attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">class</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The css class to use for element - it's an alias of cssClass attribute.</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">cssClass</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The css class to use for element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">cssErrorClass</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The css error class to use for element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">cssErrorStyle</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The css error style definitions for element to use</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">cssStyle</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The css style definitions for element to use</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">disabled</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html disabled attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">emptyOption</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Decide if an empty option is to be inserted. Default false.</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">errorPosition</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Define error position of form element (top|bottom)</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">headerKey</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the header key for the header option.</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">headerValue</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the header value for the header option.</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">id</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">HTML id attribute</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">javascriptTooltip</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">Boolean</td>
-
- <td align="left" valign="top">Use JavaScript to generate tooltips</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">key</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the key (name, value, label) for this particular component</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">label</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Label expression used for rendering an element specific label</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">labelSeparator</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">:</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">String that will be appended to the label</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">labelposition</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Define label position of form element (top/left)</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">list</td>
-
- <td align="left" valign="top"><strong>true</strong></td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Iterable source to populate from. If this is missing, the select widget is simply not displayed.</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">listKey</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the key used to retrieve the option key.</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">listValue</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the value used to retrieve the option value.</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">maxLength</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">Integer</td>
-
- <td align="left" valign="top">Deprecated. Use maxlength instead.</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">maxlength</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">Integer</td>
-
- <td align="left" valign="top">HTML maxlength attribute</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">name</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The name to set for element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onblur</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top"> Set the html onblur attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onchange</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onchange attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onclick</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onclick attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">ondblclick</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html ondblclick attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onfocus</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onfocus attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onkeydown</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onkeydown attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onkeypress</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onkeypress attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onkeyup</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onkeyup attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onmousedown</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onmousedown attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onmousemove</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onmousemove attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onmouseout</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onmouseout attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onmouseover</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onmouseover attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onmouseup</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onmouseup attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">onselect</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html onselect attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">readonly</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">Boolean</td>
-
- <td align="left" valign="top">Whether the input is readonly</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">requiredLabel</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">Boolean</td>
-
- <td align="left" valign="top">If set to true, the rendered element will indicate that input is required</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">requiredPosition</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Define required position of required form element (left|right)</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">size</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">Integer</td>
-
- <td align="left" valign="top">HTML size attribute</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">style</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The css style definitions for element to use - it's an alias of cssStyle attribute.</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">tabindex</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html tabindex attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">template</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The template (other than default) to use for rendering the element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">templateDir</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The template directory.</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">theme</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The theme (other than default) to use for rendering the element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">title</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html title attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">tooltip</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the tooltip of this particular component</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">tooltipConfig</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Deprecated. Use individual tooltip configuration attributes instead.</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">tooltipCssClass</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">StrutsTTClassic</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">CSS class applied to JavaScrip tooltips</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">tooltipDelay</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">Classic</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Delay in milliseconds, before showing JavaScript tooltips </td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">tooltipIconPath</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Icon path used for image that will have the tooltip</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">type</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">text</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Specifies the html5 type element to display. e.g. text, email, url</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">value</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Preset the value of input element.</td>
-
- </tr>
-
- </table>
-
-</p>
-{% comment %}end snippet id=tagattributes|javadoc=false|url=struts2-tags/combobox.html {% endcomment %}
-
-__Examples__
-
-
-
-{% comment %}start snippet id=example|lang=xml|javadoc=true|url=org.apache.struts2.components.ComboBox {% endcomment %}
-
-```xml
- JSP:
- <-- Example One -->
- <s:bean name="struts.util.Counter" var="year">
- <s:param name="first" value="text('firstBirthYear')"/>
- <s:param name="last" value="2000"/>
-
- <s:combobox label="Birth year" size="6" maxlength="4" name="birthYear" list="#year"/>
- </s:bean>
-
- <-- Example Two -->
- <s:combobox
- label="My Favourite Fruit"
- name="myFavouriteFruit"
- list="{'apple','banana','grape','pear'}"
- headerKey="-1"
- headerValue="--- Please Select ---"
- emptyOption="true"
- value="banana" />
-
- <-- Example Two -->
- <s:combobox
- label="My Favourite Color"
- name="myFavouriteColor"
- list="#{'red':'red','green':'green','blue':'blue'}"
- headerKey="-1"
- headerValue="--- Please Select ---"
- emptyOption="true"
- value="green" />
-
- Velocity:
- #tag( ComboBox "label=Birth year" "size=6" "maxlength=4" "name=birthYear" "list=#year" )
-
-```
-
-{% comment %}end snippet id=example|lang=xml|javadoc=true|url=org.apache.struts2.components.ComboBox {% endcomment %}
-
-#####component##### {#PAGE_14033}
-
-__Description__
-
-
-
-{% comment %}start snippet id=javadoc|javadoc=true|url=org.apache.struts2.components.GenericUIBean {% endcomment %}
-<p> <p>
- Renders an custom UI widget using the specified templates. Additional objects can be passed in to the template
- using the param tags.
- </p>
-
- <p><b>Freemarker:</b></p>
- <pre>Objects provided can be retrieve from within the template via $parameters._paramname_.</pre>
-
- <p><b>JSP:</b></p>
- <pre>Objects provided can be retrieve from within the template via <s:property value="%{parameters._paramname_}" /></pre>
-
- <p>
- In the bottom JSP and Velocity samples, two parameters are being passed in to the component. From within the
- component, they can be accessed as:
- </p>
-
- <p><b>Freemarker:</b></p>
- <pre>$parameters.get('key1') and $parameters.get('key2') or $parameters.key1 and $parameters.key2</pre>
-
- <p><b>JSP:</b></p>
- <pre>
- <s:property value="%{parameters.key1}" /> and <s:property value="%{'parameters.key2'}" /> or
- <s:property value="%{parameters.get('key1')}" /> and <s:property value="%{parameters.get('key2')}" />
- </pre>
-
- <p>
- Currently, your custom UI components can be written in Velocity, JSP, or Freemarker, and the correct rendering
- engine will be found based on file extension.
- </p>
-
- <p>
- <b>Remember:</b> the value params will always be resolved against the ValueStack so if you mean to pass a
- string literal to your component, make sure to wrap it in single quotes i.e. value="'value1'" (note the opening "' and closing '" otherwise, the the value
- stack will search for an Object on the stack with a method of getValue1().
- </p>
-</p>
-{% comment %}end snippet id=javadoc|javadoc=true|url=org.apache.struts2.components.GenericUIBean {% endcomment %}
-
-{% comment %}start snippet id=note|javadoc=true|url=org.apache.struts2.components.GenericUIBean {% endcomment %}
-<p>
- If Jsp is used as the template, the jsp template itself must lie within the
- webapp itself and not the classpath. Unlike Freemarker or Velocity, JSP template
- could not be picked up from the classpath.
-
-</p>
-{% comment %}end snippet id=note|javadoc=true|url=org.apache.struts2.components.GenericUIBean {% endcomment %}
-
-**(!) templateDir and theme attribute**
-
-
->
-
->
-
-> The final path to the template will be built using the _templateDir_ and _template_ attributes, like \${templateDir}/\${theme}/\${template}. If for example your component is under /components/html/option.jsp, you would have to set templateDir="components", theme="html" and template="options.jsp".
-
->
-
->
-
-> For any Struts tag that you use in your component, make sure that you set its templateDir="template"
-
->
-
-__Parameters__
-
-
-
-{% comment %}start snippet id=tagattributes|javadoc=false|url=struts2-tags/component.html {% endcomment %}
-<p> <table width="100%">
-
- <tr>
-
- <td colspan="6"><h4>Dynamic Attributes Allowed:</h4> false</td>
-
- </tr>
-
- <tr>
-
- <td colspan="6"> </td>
-
- </tr>
-
- <tr>
-
- <th align="left" valign="top"><h4>Name</h4></th>
-
- <th align="left" valign="top"><h4>Required</h4></th>
-
- <th align="left" valign="top"><h4>Default</h4></th>
-
- <th align="left" valign="top"><h4>Evaluated</h4></th>
-
- <th align="left" valign="top"><h4>Type</h4></th>
-
- <th align="left" valign="top"><h4>Description</h4></th>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">accesskey</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">Set the html accesskey attribute on rendered html element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">class</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The css class to use for element - it's an alias of cssClass attribute.</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">cssClass</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The css class to use for element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">cssErrorClass</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top">String</td>
-
- <td align="left" valign="top">The css error class to use for element</td>
-
- </tr>
-
- <tr>
-
- <td align="left" valign="top">cssErrorStyle</td>
-
- <td align="left" valign="top">false</td>
-
- <td align="left" valign="top"></td>
-
- <td align="left" valign="top">false</td>
-
... 29084 lines suppressed ...